Skip to content

Agent Skills

Coding agents (Claude Code, Cursor, Grok, and others) can scaffold kdeps projects for you when you install the kdeps skill.

Install the skill

Skills CLI:

bash
npx skills add https://github.com/kdeps/skill --skill kdeps

Git clone + symlink:

bash
git clone https://github.com/kdeps/skill ~/src/kdeps-skill
ln -sf ~/src/kdeps-skill/skills/kdeps ~/.claude/skills/kdeps

Both methods install the same skill from skills/kdeps/. Use ~/.cursor/skills/kdeps or ~/.grok/skills/kdeps for other agents. Add -y -g to the npx command to skip prompts and install globally.

The skill activates when you ask the agent to build a kdeps workflow, component, or agency.

What it covers

  • Choosing between a component, workflow (agent), or agency
  • All 15 primary resource actions plus apiResponse
  • Workflow input (api, bot, file), webServer, session, and kdeps serve
  • Expressions, validation, and error handling
  • Registry-ready packaging — every scaffold includes kdeps.pkg.yaml for kdeps.io distribution

Publishing to kdeps.io

Projects the skill creates are distributable by default:

bash
kdeps validate .
kdeps registry verify .
kdeps bundle package .
git tag v1.0.0 && git push --tags
kdeps registry submit --tag v1.0.0
# Open a PR to https://github.com/kdeps/registry with the printed formula

See the skill's registry reference for the full publish checklist.

Skill vs registry packages

kdeps skillYour kdeps project
What it isInstructions for coding agentsRunnable workflow / component / agency
Installnpx skills add https://github.com/kdeps/skill --skill kdepskdeps registry install <name>
Manifestskills/kdeps/SKILL.mdkdeps.pkg.yaml

The skill teaches agents how to write YAML that installs from kdeps.io. It is not itself a registry package.

See also

Released under the Apache 2.0 License.