decktalk init installs the six skills into a new project by default. Pass --no-skills to leave
them out.
The folders
The skills are written once, into one generic folder, and a second folder points at it.
On a machine where a link cannot be made, which is usually Windows without the privilege for one,
init writes a copy instead of a link. The copy holds the same files, and it has to be written
again when the skills change.
Do not commit a second copy of a skill under another name. Several harnesses read both folders, and
two copies of one skill is the case where a harness has to guess.
Which harness reads which folder
Every harness below loads aSKILL.md natively. The folders are the ones each harness documents for
a project.
The two folders that
init writes reach every harness in that table. .agents/skills/ reaches
eight of them, and .claude/skills reaches Claude Code, which is the one harness that does not read
the generic folder.
Why the skills use no harness-specific fields
DeckTalk skills use only the fields the open format defines, which arename, description,
license, compatibility and metadata. Several harnesses add fields of their own, and a field
that one harness honours and another ignores gives one skill two behaviours. Some services also
reject a skill whose front matter carries a key they do not know.
The cost of that choice is that no front-matter field can mark a skill as user-only, so the guards
against spending live in the skill text and in the CLI. Agent skills lists them.
Install the skills without installing DeckTalk
The repository carries askills folder at its root that points at the same files, so a generic
skill installer can read the skills straight from the repository before DeckTalk is on the machine.
The skills drive a CLI, so they are only useful once that CLI exists.