// Using kern
ai agents
install kern's docs as an agent skill so coding agents write plugins instead of guessing.
ai agents
these docs are packaged as an agent skill — a folder of markdown an AI coding agent loads when the task touches kern. instead of scraping the site, your agent gets the manifest reference, lifecycle rules, kern-cli surface, and automation api as local files.
the skill lives in skills/kern and its references/ directory is generated from these same docs, so the two can't drift.
install
with the skills cli (claude code, opencode, cursor, and ~70 more agents):
bashnpx skills add ellipog/kern-web
or as an npm package (pinned, offline):
bashnpm i -D @aaen-studios/kern # the skill is at node_modules/@aaen-studios/kern/kern
or copy it into whichever directory your agent scans:
bashgit clone --depth 1 https://github.com/ellipog/kern-web cp -r kern-web/skills/kern .claude/skills/kern # or .agents/skills/kern, .cursor/skills/kern, …
paste this into your agent
don't want to install anything yourself? paste a one-liner and let the agent do it:
textinstall the kern agent skill by running: npx skills add ellipog/kern-web — then use that skill to help me build a .kern plugin.
no install at all
agents that can fetch a url don't need the skill installed:
- llms.txt — an index of every doc for ai tooling
- llms-full.txt — the whole documentation in one response
/raw/docs/<slug>— the author-written markdown, frontmatter included, e.g./raw/docs/manifest-reference
what the agent gets
- a
SKILL.mdrouter explaining when kern applies and which reference to read references/manifest-reference— the.kernpackage andmanifest.jsonschemareferences/lifecycle,references/config-schema,references/scaffold,references/plugin-ui— plugin authoringreferences/cliandreferences/automation-api— controlling a running app- plus every other page in these docs
// note
the skill is a documentation bundle, not a tool. installing it grants your agent no new access — it just knows what to write.
keeping it current
the npm package is versioned separately from the app; npx skills update kern (or reinstalling) picks up new docs. contributing? after editing any page here, run npm run skill:build so the bundled references regenerate, and npm run skill:check will fail the build if they're stale.