OpenKingdom Skill

An Agent Skill + Claude Code plugin that gives AI coding agents deep, source-verified context for the OpenKingdom toolkit — the company's @open-kingdom/* npm packages for building NestJS + React apps.

It teaches an agent to compose the existing 33 packages instead of re-implementing primitives, and it corrects several mistakes in the packages' own READMEs that would otherwise lead agents to write broken code.

Works in any Agent-Skills-compatible tool — Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, and others.

What's inside

skills/
  open-kingdom/          Reference skill — package map, decision checklists, wiring, doc corrections
    SKILL.md
    references/          backend · frontend · crm-poly · wiring · architecture
  scaffold-backend/      Workflow: add a NestJS feature (lib → table → module → schema → AppModule → RBAC)
  scaffold-frontend/     Workflow: add a React feature (lib → baseApi/slice → store → UI → routes)
  new-domain/            Workflow: scaffold a whole domain vertical (mirrors the CRM)
agents/
  open-kingdom.md        OpenKingdom-aware engineer agent (preloads the reference skill)
.claude-plugin/
  plugin.json            Claude Code plugin manifest

Install

Cross-platform (Agent Skills CLI)

npx skills add open-kingdom-ai

This installs the skills into your project's skills directory (.claude/skills/, .agents/skills/, etc., depending on the tool). The reference skill activates automatically when you work with @open-kingdom/* code; invoke a workflow directly with /scaffold-backend, /scaffold-frontend, or /new-domain.

Claude Code (as a plugin — richer)

Installing as a plugin adds the dedicated open-kingdom agent and namespaces the skills (/open-kingdom:scaffold-backend, …):

# from a local clone, for development:
claude --plugin-dir /path/to/open-kingdom-skill

# or publish to a marketplace and:
/plugin install open-kingdom@<your-marketplace>

Manual

Copy skills/open-kingdom/ into your project's .claude/skills/ (Claude Code) or .agents/skills/ (VS Code / Copilot). Copy the other skills/* and agents/* too if your tool supports them.

Usage

• Ask naturally — "add a backend feature for invoices", "build the settings page" — and the agent reuses the right packages and follows the boundaries.
• Invoke a workflow — /scaffold-backend invoices, /scaffold-frontend settings, /new-domain billing.
• The reference skill loads on demand; its references/*.md carry the full per-package API detail.

Maintaining

The content is source-verified against the OpenKingdom monorepo, not just the package READMEs (which contain known errors — see the "Known doc discrepancies" section in skills/open-kingdom/SKILL.md). When the packages change, update the reference files here and bump version in package.json and .claude-plugin/plugin.json.