@contentrain/skills

@contentrain/skills

Workflow skills and framework guides for Contentrain-aware AI agents.

Start here:

• 2-minute product demo
• Rules & skills docs
• Framework integration guide

This package follows the Agent Skills standard for progressive disclosure: each skill has a SKILL.md (loaded on activation) and optional references/*.md (loaded on demand).

Install

Via npm (programmatic access to catalogs and constants)

pnpm add @contentrain/skills

Via skills CLI (install skills into your AI agent)

# Install all 16 skills
npx skills add Contentrain/ai/packages/skills

# Install a specific skill
npx skills add Contentrain/ai/packages/skills --skill contentrain-normalize

# Install to a specific agent
npx skills add Contentrain/ai/packages/skills --agent claude-code

# List available skills
npx skills add Contentrain/ai/packages/skills --list

Works with Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Gemini CLI, and 40+ other agents.

What It Contains

Agent Skills (standard format)

Published under skills/ — 16 production skills:

Each skill directory contains:

skills/{name}/
├── SKILL.md           # Instructions (< 500 lines, quick reference)
└── references/        # Detailed docs (loaded on demand)
    └── *.md           # Deep dives: architecture, patterns, examples

Example references: contentrain/references/mcp-tools.md, contentrain-normalize/references/extraction.md, contentrain-quality/references/seo.md.

Workflow skills (backward compat)

Published under workflows/ — flat markdown files retained for compatibility:

• contentrain-init.md, contentrain-model.md, contentrain-content.md, contentrain-bulk.md
• contentrain-normalize.md, contentrain-validate-fix.md, contentrain-review.md
• contentrain-diff.md, contentrain-doctor.md, contentrain-serve.md
• contentrain-generate.md, contentrain-translate.md

Still fully functional; new projects should prefer the skills/ structure.

Framework guides

Published under frameworks/ — per-framework integration patterns:

• nuxt.md, next.md, astro.md, sveltekit.md (meta frameworks)
• react.md, vue.md (UI libraries)
• expo.md, react-native.md (mobile)
• node.md (backend)

Public Exports

import { AGENT_SKILLS, WORKFLOW_SKILLS, FRAMEWORK_GUIDES } from '@contentrain/skills'

// Discover skills: name + description for agent activation
AGENT_SKILLS.forEach(({ name, description }) => {
  console.log(`${name}: ${description}`)
})

// Backward compat: flat workflow list
console.log(WORKFLOW_SKILLS.length) // 12

// Framework discovery
console.log(FRAMEWORK_GUIDES)

Progressive Disclosure

This reduces always-loaded context from thousands of lines to just the essentials plus catalog.

Parity with @contentrain/mcp

@contentrain/skills is kept in lockstep with the MCP tool registry via cross-package parity tests (tests/mcp-parity.test.ts):

• skills/contentrain/references/mcp-tools.md must have an ### <tool> heading for every tool in the MCP TOOL_NAMES registry (currently 27: 22 core + 5 media).
• Key skills (normalize, translate) must not reference legacy contentrain/{operation}/... branch prefixes — MCP now emits cr/*.

When MCP's surface changes, these tests fail until the skill docs catch up.

IDE Support

Skills are installed by contentrain init (and re-applied with contentrain skills --update) for detected IDEs:

Build

From the monorepo root:

pnpm --filter @contentrain/skills build
pnpm --filter @contentrain/skills test
pnpm --filter @contentrain/skills typecheck

License

MIT