Claude Code Compat Skill banner
LeeorNahum LeeorNahum

Claude Code Compat Skill

Development community

Description

Agent Skill that bridges AGENTS.md and .agents/skills into Claude Code's native CLAUDE.md.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

claude-code-compat

A Claude Code compatibility skill. It maintains a managed block in `CLAUDE.md` so Claude Code can see an `AGENTS.md` and the skills under `.agents/skills`, neither of which it discovers natively.

Why

Claude Code reads `CLAUDE.md` and `.claude/skills`. Repositories that follow the cross-tool `AGENTS.md` and `.agents/skills` conventions are invisible to it. This skill bridges that gap with no symlinks and no per-clone setup.

What it does

Running the generator writes one managed block into `CLAUDE.md`:

  • Imports the repository's AGENTS.md
  • Lists each skill under .agents/skills by name, direct SKILL.md path, and description
  • Tells Claude Code to read the listed SKILL.md path directly when a skill is relevant, because these project skills are not native slash-command skills

Claude Code then has the trigger description and direct file path it needs to load the project skill. Anything you keep in `CLAUDE.md` outside the block is left untouched.

Use

From the repository root, use either route:

# Installed skill
node /scripts/claude-compat.mjs

# Public repository
npx --yes github:LeeorNahum/claude-code-compat-skill

Run it whenever skills change. The block is regenerated in place, idempotently. Node is the only requirement. See `SKILL.md` for the full trigger conditions and behavior.