https://github.com/dceoy/speckit-agent-skills
Agent skills for Spec Kit
https://github.com/dceoy/speckit-agent-skills
agent-skills ai-agents ai-coding claude-code codex-cli developer-tools gemini-cli github-copilot spec-kit specifications workflow-automation
Last synced: 4 months ago
JSON representation
Agent skills for Spec Kit
- Host: GitHub
- URL: https://github.com/dceoy/speckit-agent-skills
- Owner: dceoy
- License: agpl-3.0
- Created: 2026-01-05T12:20:01.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-28T20:00:00.000Z (5 months ago)
- Last Synced: 2026-02-15T16:40:10.059Z (4 months ago)
- Topics: agent-skills, ai-agents, ai-coding, claude-code, codex-cli, developer-tools, gemini-cli, github-copilot, spec-kit, specifications, workflow-automation
- Language: Shell
- Homepage:
- Size: 423 KB
- Stars: 21
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# speckit-agent-skills
Agent skills for [Spec Kit](https://github.com/github/spec-kit)
## Overview
This repository provides reusable skills and templates for multiple agent runtimes:
- **Shared skills** - Source skills live in `skills/` and are symlinked to `.claude/skills`, `.codex/skills`, and `.github/skills`
- **Claude Code** - Spec Kit commands in `.claude/commands/` (skills via the symlinked `.claude/skills`)
- **Codex CLI** - Prompt files in `.codex/prompts/` (skills via the symlinked `.codex/skills`)
- **GitHub Copilot CLI** - Agent files in `.github/agents/`, prompt files in `.github/prompts/`, skills via `.github/skills`
- **Gemini CLI** - Command files in `.gemini/commands/`
- **Spec Kit** - Spec-Driven Development workflow skills (`speckit-*`) across all runtimes
Each skill directory has a `SKILL.md` with YAML front matter that includes the skill configuration and documentation.
## Quickstart
1. Clone this repository and change into it.
```bash
git clone https://github.com/github/speckit-agent-skills.git
```
2. Install [Spec Kit](https://github.com/github/spec-kit).
3. Create a new project or initialize an existing project using `specify init`.
4. Copy the `skills/` directory into the project's agent skills directory (e.g., `.claude/skills/`).
```bash
cp -a speckit-agent-skills/skills/* /path/to/a/project/agent/directory/skills/
```
5. Use the skills on your preferred agent (e.g., Claude Code).
### Spec Kit Workflow
This repository implements the **Spec-Driven Development** methodology via Spec Kit skills. The canonical workflow:
1. **Constitution** → Define project principles
2. **Specify** → Capture feature requirements (what/why)
- Or **Baseline** → Generate specs from existing code
3. **Clarify** (optional) → Resolve ambiguities
4. **Plan** → Create technical strategy (how)
5. **Analyze** (optional) → Validate consistency
6. **Tasks** → Generate ordered work items
7. **Implement** → Execute development
See **[AGENTS.md](./AGENTS.md#spec-kit-workflow)** for the complete workflow guide with examples and best practices.
#### Visual workflow
```mermaid
flowchart TD
%% Core (recommended order)
C0["speckit-constitution"] --> C1["speckit-specify"] --> C2["speckit-plan"] --> C3["speckit-tasks"] --> C4["speckit-implement"]
%% Alternative entry for existing code
C0 --> FC["speckit-baseline"]
FC --> C2
%% Optional (dashed = insert/assist)
C1 -.-> O1["speckit-clarify"]
FC -.-> O1
O1 -.-> C2
C3 -.-> O2["speckit-analyze"]
O2 -.-> C4
C3 -.-> O4["speckit-taskstoissues"]
C1 -.-> O3["speckit-checklist"]
FC -.-> O3
C2 -.-> O3
C3 -.-> O3
```
## Skills by runtime
### Shared skills (`skills/`)
- `speckit-*` - Spec Kit workflow skills
### Runtime access
- **Claude Code:** `.claude/commands/` (Spec Kit prompts) and `.claude/skills` (symlink to `../skills`)
- **Codex CLI:** `.codex/prompts/` (Spec Kit prompts) and `.codex/skills` (symlink to `../skills`)
- **GitHub Copilot CLI:** `.github/agents/` (Spec Kit agents), `.github/prompts/`, `.github/skills` (symlink to `../skills`)
- **Gemini CLI:** `.gemini/commands/` (Spec Kit prompts)
## Structure
```
.
├── skills/ # Source skills (speckit-*)
├── .claude/
│ ├── commands/ # Claude Code command prompts (speckit.*)
│ └── skills -> ../skills
├── .codex/
│ ├── prompts/ # Codex CLI prompt files (speckit.*)
│ └── skills -> ../skills
├── .gemini/
│ └── commands/ # Gemini CLI prompt files (speckit.*.toml)
├── .github/
│ ├── agents/ # GitHub Copilot CLI agents (speckit.*.agent.md)
│ ├── prompts/ # GitHub Copilot CLI prompts (speckit.*.prompt.md)
│ ├── skills -> ../skills
│ └── workflows/ # CI workflows (ci.yml)
└── .specify/ # Spec Kit templates and memory files
├── memory/
├── scripts/
│ └── bash/ # Helper scripts used by skills
└── templates/ # spec, plan, tasks, checklist, agent-file templates
```
## Prerequisites
Install and authenticate the required CLI tools before running skills:
- **Claude Code** - For `.claude/commands/` and shared skills via `.claude/skills`
- **GitHub Copilot CLI** - For `.github/agents/` and shared skills via `.github/skills`
- **OpenAI Codex CLI** - For `.codex/prompts/` and shared skills via `.codex/skills`
- **Gemini CLI** - For `.gemini/commands/`
- **Spec Kit** - Install from [github.com/github/spec-kit](https://github.com/github/spec-kit)
## Usage notes
- Skills do not always auto-run; use your agent's skill invocation flow or ask for the skill explicitly.
- If a skill fails, open its `SKILL.md` and verify prerequisites and command syntax.
- Spec Kit helper scripts live in `.specify/scripts/bash` (bash-only). Run them from repo root and prefer their `--json` output (absolute paths).
## Contributing
See [AGENTS.md](./AGENTS.md) for repository guidelines and agent-specific rules.
## License
See [LICENSE](./LICENSE) for details.