skills-vault/docs/ccpe-relationship.md

2.4 KiB

Relationship Between skills-vault And CCPE System

Short Version

skills-vault and ccpe-system are complementary, not competing.

skills-vault = automation Skill implementation source
ccpe-system  = agentic system architecture and high-level artifacts

Existing CCPE content should not be migrated into skills-vault.

Future migrations into skills-vault are limited to automation Skills that live outside CCPE System.

What Belongs In skills-vault

Use skills-vault for automation-oriented Skills such as:

  • Markdown transformers
  • file cleanup tools
  • citation checkers
  • report exporters
  • batch processors
  • source splitters
  • installable Codex or Claude Code Skills
  • scripts and tests that implement repeatable Skill behavior

These Skills usually have:

  • a SKILL.md
  • deterministic procedures
  • scripts
  • tests or fixtures
  • clear file-operation boundaries

What Belongs In CCPE System

Use ccpe-system for:

  • CCPE-Lite prompt cards
  • durable agent specs
  • committees
  • runtimes
  • model cards
  • model indexes
  • cognitive model assets
  • architecture registrations for important Skills

CCPE may reference a Skill from this repository, but should not duplicate the Skill source.

When To Register A Skill In CCPE

Do not register every small utility.

Create a lightweight CCPE registration only when a Skill becomes part of a larger agentic system, for example:

  • a CCPE runtime calls the Skill
  • a committee depends on the Skill
  • an agent spec lists the Skill as a required capability
  • the Skill has meaningful authority, safety, or evaluation rules
  • the Skill becomes part of a repeatable workflow

Example Registration Relationship

If fix-title is migrated into this repository:

skills-vault/
  skills/
    fix-title/
      SKILL.md
      scripts/
      tests/

If later needed by CCPE, CCPE may add:

ccpe-system/
  skills/
    tool/
      fix-title.skill.md

That CCPE file should record only architecture metadata:

canonical implementation: skills-vault/skills/fix-title
installed path: C:\Users\wangq\.agents\skills\fix-title
skill type: tool-skill / transformation-skill
used by: ...
authority: ...
validation: ...

It should not copy implementation source from skills-vault.

Current Policy

Do not migrate any existing CCPE content into skills-vault.
Only migrate automation Skills outside CCPE System.