# 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.

See [PROJECTS.md](PROJECTS.md) for the project overview and cross-repository boundaries.

## 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
```

## Demand Sources

New Skills should come from real workflow needs, not speculative candidate lists.

Valid sources are:

- business systems such as `video-workbench`, `writing-workbench`, `knowledge-vault`, or `ccpe-system`
- local workflow automation discovered during day-to-day work, such as `fix-title`

Business systems use installed Skills from `C:\Users\wangq\.agents\skills`. This repository owns the source copy only when the automation has become stable enough to maintain as a reusable Skill.

## Remote

Canonical remote:

```text
https://git.wantsong.life/wantsong/skills-vault.git
```