Skilldeck

skilldeck

Use this skill when an agent needs to inspect or move existing SKILL.md folders between local agent environments.

Inputs

• A local skill folder containing SKILL.md, or a pack with nested skills/<name>/SKILL.md entries.
• A target host name: codex, claude, openclaw, or agents.
• An explicit destination path when running in CI, tests, or any shared workspace.

Tools

• skilldeck validate <path> --strict validates pack structure and metadata.
• skilldeck report <path> --json creates a deterministic compatibility report.
• skilldeck install <path> --target <target> --dest <dir> --dry-run previews copied files.
• skilldeck pack <docsDir> --name <skill-name> --out <dir> creates a starter skill from local docs.
• Strict validation expects activation, sideEffects, and approvalRequired frontmatter arrays in portable skill packs.

Side Effects

validate, report, and dry-run install are read-only. Non-dry-run install copies files into the selected local destination. pack writes a new local skill directory. No command executes skill content, reads credentials, calls remote services, or publishes packages.

Approval Boundaries

Ask for explicit approval before installing into a live agent home directory, overwriting an existing skill with --force, or using generated skill text as a standing workflow.

Validation

Run:

npm run release:check

For a sample pack:

skilldeck validate ./fixtures/valid-pack --strict
skilldeck install ./fixtures/valid-pack --target agents --dest /tmp/skilldeck-demo --dry-run
skilldeck report ./fixtures/valid-pack --json

Example

skilldeck pack ./docs --name project-docs --out ./skills
skilldeck validate ./skills/project-docs --strict