@a16njs/plugin-claude


Claude Code plugin for a16n. Discovers and emits Claude configuration.

Installation

This plugin is bundled with the a16n CLI. For programmatic use:

``bash
npm install @a16njs/plugin-claude
`

Supported Types

This plugin supports five customization types:

| Type | Claude Format | Description |
|------|---------------|-------------|
| GlobalPrompt | .claude/rules/*.md | Always-active instructions |
| FileRule | .claude/rules/*.md with paths: frontmatter | Glob-triggered via native paths |
| SimpleAgentSkill | .claude/skills/*/SKILL.md | Description-triggered skills |
| AgentIgnore | .claude/settings.json permissions.deny | Files to exclude |
| AgentCommand | Emitted only | Cursor commands become skills |

> Note: Claude has no dedicated command concept. AgentCommands from Cursor are emitted as skills with a description enabling /command-name invocation. The Claude plugin never discovers AgentCommands—conversion is one-way (Cursor → Claude only).

Supported Files

$3

- CLAUDE.md - Root Claude configuration (GlobalPrompt)
- */CLAUDE.md - Nested Claude configuration files (GlobalPrompt)
- .claude/rules/*.md - Native Claude rules (GlobalPrompt if no paths:, FileRule if paths: present)
- .claude/skills/*/SKILL.md - Skills with description frontmatter (SimpleAgentSkill)
- .claude/settings.json - Permissions deny rules (AgentIgnore)

> Note: Skills with hooks: in their frontmatter are skipped (not convertible to Cursor).
> Note: Only Read() permission denials are discovered (other types like Bash() or Edit() are ignored).

$3

- GlobalPrompt → .claude/rules/.md (individual files)
- FileRule → .claude/rules/.md with paths: YAML frontmatter
- SimpleAgentSkill → .claude/skills//SKILL.md with description frontmatter
- AgentIgnore → .claude/settings.json with permissions.deny Read rules
- AgentCommand → .claude/skills//SKILL.md with Invoke with /command description

File Formats

$3

Rules without paths: frontmatter apply to all files:

`markdown


From: .cursor/rules/general.mdc

Your instructions for Claude here.
`

$3

Rules with paths: frontmatter apply only when working with matching files:

`markdown
---
paths:
- "*/.tsx"
- "*/.jsx"
---

From: .cursor/rules/react.mdc

Use functional components with hooks.
`

$3

`markdown
---
description: Testing best practices
---

Write unit tests first.
Aim for 80% code coverage.
`

Usage

`typescript
import claudePlugin from '@a16njs/plugin-claude';
import { A16nEngine } from '@a16njs/engine';

const engine = new A16nEngine([claudePlugin]);

// Discover Claude configuration
const result = await claudePlugin.discover('./my-project');
console.log(Found ${result.items.length} items);

// Emit to Claude format
await claudePlugin.emit(result.items, './my-project');
``

Documentation

Full documentation available at .