https://github.com/rickygao/specrate
An agent skill to manage specs and changes.
https://github.com/rickygao/specrate
agent-skills github-copilot spec spec-driven-development
Last synced: 2 months ago
JSON representation
An agent skill to manage specs and changes.
- Host: GitHub
- URL: https://github.com/rickygao/specrate
- Owner: rickygao
- License: apache-2.0
- Created: 2025-12-22T06:26:25.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-01-13T09:13:09.000Z (3 months ago)
- Last Synced: 2026-01-13T11:43:22.084Z (3 months ago)
- Topics: agent-skills, github-copilot, spec, spec-driven-development
- Homepage:
- Size: 16.6 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-agent-skills - Specrate
README
# Specrate
Specrate is an agent skill that manages specs and changes in a structured way. It provides a framework for proposing, planning, implementing, and archiving changes to the system's specs.
## Installation
Ensure your agent supports [agent skills](https://agentskills.io) and install the skill by git-cloning into your repo's `.github/skills` folder. Replace `.github/skills` with the appropriate path if your agent uses a different location for skills.
Note: the skill itself is installed under `.github/skills/specrate`, while the documents it manages are created/updated under `.specrate/` at your repository root.
### Bash
```sh
git clone --depth 1 https://github.com/rickygao/specrate .github/skills/specrate
rm -rf .github/skills/specrate/.git
```
### PowerShell
```pwsh
& git clone --depth 1 https://github.com/rickygao/specrate .github/skills/specrate
Remove-Item -Path .github/skills/specrate/.git -Recurse -Force
```
## Usage
Specrate manages spec and change artifacts under `.specrate/` at the repository root (see [references/PRINCIPLE.md](./references/PRINCIPLE.md) for conventions).
1. Show current status: "Show the current status of specs and changes"
2. Propose a new change: "Propose a new change to {description of the change}"
3. Amend an existing change: "Amend the change {change-id}: {description of the amendment}"
4. Plan a proposed change: "Plan the proposed {change-id}"
5. Implement a planned change: "Implement the planned {change-id}"
6. Archive an implemented change: "Archive the implemented {change-id}"
7. Fix a spec from codebase: "Fix the spec for {spec-id, or description of the spec scope} from the codebase"
Refer to the [SKILL.md](./SKILL.md) file for how the skill works in detail.
## Acknowledgements
This skill was heavily inspired by the [OpenSpec](https://openspec.dev).