Skilldeck

Local-first skill pack manager and verifier for agent instructions.

Install

npx -y skills add rogerchappel/skilldeck

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Validate, report on, pack, and locally install reusable agent skill folders.

SKILL.md

2.2 KB, 418 tokens by cl100k_base, as published. Nobody here has run it

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