Skip to content

Skill for coding agents

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

Applies to both modes. This page is the skill file for coding agents, not kdeps agent-mode skills.

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 agent REPL (kdeps [path])
  • 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.