| name | skill-manager |
| description | Manage ArkSpace by creating skills, recording upstream sources, assigning roles, validating registries, and guiding mirror, adapted, local, and reference-only skill updates. |
Skill Manager
Manage skills as durable package assets, not one-off prompt snippets.
Use this skill when creating a skill, adapting an external skill, recording upstream provenance, assigning a skill to a role, validating the skills package, or preparing a selective upstream update.
Workflow
- Classify the request: create, adapt, mirror, validate, assign role, document, or review upstream changes.
- Check
registry/skills.yaml, registry/sources.yaml, and registry/roles.yaml before editing.
- Keep skill bodies under
skills/<skill-name>/SKILL.md.
- Record source provenance for every reused or adapted skill.
- Assign each active skill to at least one role unless it is intentionally standalone.
- Run
python3 scripts/validate-skills.py after registry, role, manifest, or skill changes.
Sync Modes
| syncMode | Meaning | Update behavior |
|---|
mirror | External skill kept close to upstream | Prefer direct sync, preserve upstream behavior, record version or commit when available |
adapted | External skill changed for this package | Compare upstream changes and merge selectively |
local | Skill created here | Maintain directly |
reference-only | Upstream used only as design reference | Do not publish it as a local skill unless explicitly promoted |
Creating a Skill
- Create
skills/<skill-name>/SKILL.md.
- Add YAML frontmatter with
name and description.
- Keep instructions host-neutral unless the skill is intentionally platform-specific.
- Add the skill to
registry/skills.yaml.
- Add or update any needed source in
registry/sources.yaml.
- Assign the skill to one or more roles.
- Run validation.
Adapting an External Skill
- Record the upstream in
registry/sources.yaml.
- Add the skill with
syncMode: adapted.
- Keep a concise note about why it diverges from upstream.
- Preserve license and attribution requirements.
- Review upstream updates manually before merging.
Validation
Run:
python3 scripts/validate-skills.py
Validation must pass before committing registry, role, skill, or manifest changes.
