95 lines
2.0 KiB
Markdown
95 lines
2.0 KiB
Markdown
# skills-vault
|
|
|
|
`skills-vault` is the source repository for automation-oriented Skills.
|
|
|
|
It is used to collect, maintain, test, version, and publish reusable Skill source code that can be installed into local agent runtimes such as:
|
|
|
|
```text
|
|
C:\Users\wangq\.agents\skills
|
|
```
|
|
|
|
## Repository Role
|
|
|
|
This repository owns the implementation source for automation Skills:
|
|
|
|
- `SKILL.md`
|
|
- scripts
|
|
- tests
|
|
- fixtures
|
|
- examples
|
|
- install notes
|
|
- migration records
|
|
|
|
It does not own CCPE agents, committees, runtimes, model cards, or existing CCPE System assets.
|
|
|
|
## Relationship To CCPE System
|
|
|
|
`C:\Users\wangq\Documents\Codex\ccpe-system` remains the system architecture workspace for:
|
|
|
|
- expert agents
|
|
- committees
|
|
- runtimes
|
|
- model cards
|
|
- model indexes
|
|
- CCPE Skill specifications and architecture registrations
|
|
|
|
`skills-vault` is separate. It stores automation Skill source code.
|
|
|
|
The current and future migration scope is:
|
|
|
|
```text
|
|
Only automation Skills outside CCPE System are migrated into this repository.
|
|
Existing CCPE content is not migrated into this repository.
|
|
```
|
|
|
|
See [docs/ccpe-relationship.md](docs/ccpe-relationship.md) for the boundary.
|
|
|
|
## Layout
|
|
|
|
```text
|
|
skills-vault/
|
|
skills/
|
|
<skill-name>/
|
|
SKILL.md
|
|
README.md
|
|
scripts/
|
|
tests/
|
|
fixtures/
|
|
templates/
|
|
skill/
|
|
docs/
|
|
registry/
|
|
scripts/
|
|
```
|
|
|
|
## Skill Migration Workflow
|
|
|
|
1. Identify an automation Skill outside CCPE System.
|
|
2. Copy or reconstruct its source under `skills/<skill-name>/`.
|
|
3. Preserve original behavior first.
|
|
4. Add or repair tests where practical.
|
|
5. Register it in `registry/skills-index.md`.
|
|
6. Optionally install or sync it into `C:\Users\wangq\.agents\skills`.
|
|
7. Only create a CCPE registration later if a CCPE agent, runtime, or committee explicitly depends on it.
|
|
|
|
See [docs/migration-guide.md](docs/migration-guide.md).
|
|
|
|
## Naming
|
|
|
|
Use lowercase kebab-case:
|
|
|
|
```text
|
|
fix-title
|
|
markdown-normalizer
|
|
citation-checker
|
|
report-exporter
|
|
```
|
|
|
|
## Remote
|
|
|
|
Canonical remote:
|
|
|
|
```text
|
|
https://git.wantsong.life/wantsong/skills-vault.git
|
|
```
|