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