wantsong
/
skills-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
skills-vault/AGENTS.md

2.4 KiB
Raw Permalink Blame History

Agent Instructions

This repository is the source vault for automation-oriented Skills.

Scope

Work in this repository should focus on:

  • collecting automation Skill source code
  • maintaining SKILL.md files
  • maintaining scripts, tests, fixtures, and examples
  • documenting migration and installation workflows
  • keeping a lightweight registry of available Skills

Do not migrate existing CCPE System content into this repository. Do not pre-register speculative Skill candidates. Skills should come from real business-system needs or recurring local workflow automation.

Boundary With CCPE

skills-vault owns automation Skill implementation source.

ccpe-system owns:

  • expert agents
  • committees
  • runtimes
  • model cards
  • model indexes
  • architectural registrations for important Skills

If an automation Skill becomes a dependency of a CCPE runtime, agent, or committee, create only a lightweight CCPE registration in ccpe-system. Do not duplicate this repository's implementation source there.

Editing Rules

  • Prefer small, focused changes.
  • Keep Skill directories self-contained.
  • Use lowercase kebab-case for Skill names and file names.
  • Run Python code and tests through the shared skills-vault conda environment by default, for example conda run -n skills-vault python .... Use another environment only when a concrete dependency conflict requires it.
  • Use repository-local temporary paths for tests by default, under C:\Users\wangq\Documents\Codex\skills-vault\tmp, instead of relying on the Windows user temp directory.
  • Read and write repository text files as UTF-8 by default. In PowerShell, pass -Encoding UTF8 for file reads/writes when the cmdlet supports it; do not rely on GBK or other system-default encodings.
  • Preserve behavior during first migration; refactor only after baseline behavior is captured.
  • Add tests for transformations, file rewrites, parsing behavior, and safety checks when practical.
  • Do not write secrets, tokens, machine-specific credentials, or generated cache files into the repository.
  • Do not treat business systems such as video-workbench as direct consumers of this repository. They should use installed Skills from .agents/skills; this repository owns source copies.

Expected Skill Directory

skills/<skill-name>/
  SKILL.md
  README.md
  scripts/
  tests/
  fixtures/

Use templates/skill for new migrations.