77 lines
1.8 KiB
Markdown
77 lines
1.8 KiB
Markdown
# skills-vault Architecture
|
|
|
|
## Purpose
|
|
|
|
`skills-vault` is a monorepo for automation Skill source code.
|
|
|
|
The repository is intentionally lightweight. It should make Skills easy to find, inspect, test, migrate, and install without turning the repository into an agent framework.
|
|
|
|
## Primary Units
|
|
|
|
### Skill Source
|
|
|
|
Each Skill lives under:
|
|
|
|
```text
|
|
skills/<skill-name>/
|
|
```
|
|
|
|
A Skill directory should contain the runnable or installable source for one capability.
|
|
|
|
### Registry
|
|
|
|
`registry/skills-index.md` is the human-readable index of Skills in this repository.
|
|
|
|
It should answer:
|
|
|
|
- What Skills exist?
|
|
- What do they do?
|
|
- Where did they come from?
|
|
- What is their migration status?
|
|
- Are they installed locally?
|
|
- Do they have any CCPE registration?
|
|
|
|
### Templates
|
|
|
|
`templates/skill/` contains a baseline structure for migrated or newly created Skills.
|
|
|
|
Use templates as starting points, not as strict bureaucracy. Small Skills may omit directories they do not need.
|
|
|
|
### Scripts
|
|
|
|
Top-level `scripts/` is for repository-level helper scripts only, such as future install, sync, validation, or registry tools.
|
|
|
|
Skill-specific scripts should stay inside each Skill directory.
|
|
|
|
## Non-Goals
|
|
|
|
This repository does not:
|
|
|
|
- store CCPE agents
|
|
- store CCPE committees
|
|
- store CCPE runtimes
|
|
- store CCPE model cards
|
|
- replace `ccpe-system`
|
|
- replace `knowledge-vault`
|
|
- act as the local installed runtime directory
|
|
|
|
## Installation Surface
|
|
|
|
The local runtime install surface is separate:
|
|
|
|
```text
|
|
C:\Users\wangq\.agents\skills
|
|
```
|
|
|
|
Future sync scripts may copy selected Skill directories from `skills-vault/skills/` into that install directory.
|
|
|
|
## Design Principle
|
|
|
|
Keep source ownership simple:
|
|
|
|
```text
|
|
Implementation source: skills-vault
|
|
Runtime install copy: .agents/skills
|
|
Architecture registration: ccpe-system, only when needed
|
|
```
|