Claude Code integration

June 18, 2026 ยท View on GitHub

lessonweaver exports reviewed skills into the three instruction mechanisms Claude Code reads. lessonweaver is an export tool, not a Claude Code integration: it generates text that you review and place yourself. Nothing is installed or committed automatically.

Claude Code formats may change. Treat these exports as reviewed project guidance and a starting point, not a guaranteed contract.

Which format to use

FormatCLI --formatTargetWhen to use
SKILL.mdclaude-skillA skill file invokable via the skill systemA self-contained, reusable operational skill
Rule fragmentclaude-rule.claude/rules/A concise always-on rule loaded automatically
CLAUDE.md snippetclaude-mdCLAUDE.mdShort project-level guidance loaded into every session
lessonweaver export-skill <skill-id-or-json> --format claude-skill
lessonweaver export-skill <skill-id-or-json> --format claude-rule
lessonweaver export-skill <skill-id-or-json> --format claude-md

claude-skill emits a full SKILL.md (when-to-use, when-NOT-to-use, instructions, anti-patterns, and a metadata section); empty sections are suppressed. claude-rule and claude-md emit compact fragments.

The legacy --format claude / claude_skill still produces the original short fragment and is kept for backward compatibility.

What lessonweaver does not do

  • It does not install skills into Claude Code or run hooks.
  • It does not test against a real Claude Code installation.
  • Exports redact by default. Use --no-redact only when you intentionally need raw content, and review the output before committing โ€” these files are loaded into agent context.