1.8 KiB
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:
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:
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:
Implementation source: skills-vault
Runtime install copy: .agents/skills
Architecture registration: ccpe-system, only when needed