skill-maker
Skills authoring
Author, lint, and publish skills for Claude Code, Codex, and OpenCode. Skills distributed with the skills package manager keep their source in a separate git repo; repo-owned local skills can instead live directly in the consuming repo.
Package-manager policy: rolling skills@latest. Use npx -y skills@latest for the interactive workstation commands and SessionStart hooks in this skill and its README examples. This deliberately lets newly published third-party installer code execute unattended at session start in exchange for automatic package-manager fixes and features; skill source URLs and refs remain controlled independently. Pin the package manager instead in CI, privileged automation, or another environment that requires reviewed, reproducible executable code.
Classify the skill before editing
A skill path can be an authored source or a package-manager-owned installed copy. Edit only an authored source.
| Kind | Where | Edit it? |
|---|---|---|
| Published source | the skill's source repo (<name>/SKILL.md) |
Yes |
| Repo-local source | <repo>/.agents/skills/<name>/ for a cross-agent skill; <repo>/.claude/skills/<name>/ only when intentionally Claude-only |
Yes |
| npx-installed copy | a global or project target directory, or the canonical .agents/skills store plus projections |
No — derived; npx -y skills@latest add/update overwrites it |
For a published skill, publishing is pull-based, not live editing. Change the source repo, then npx -y skills@latest update re-pulls and rewrites the installed copy. An edit made directly to the installed copy is discarded on the next update. For a repo-local source, commit the real directory and its compatibility symlink in the consuming repo; no package-manager install step applies.