skills.rest
RatnaAtika
RatnaAtikaCOMMUNITY
Explore all skills by this author →
GitHub

agent-harness-compatibility

Generates per-harness adapters so one SKILL.md works across Codex, Cursor, Claude Code, and other agent harnesses.

Updated May 29, 2026
Search Tags:#claude code#skill.md#codex cli#aider#agent harness#adapter generation#cursor rules
One-click install
npx skills add https://github.com/RatnaAtika/Indonesian-ASR-11-Class-Dataset --skill agent-harness-compatibility-ratnaatika
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-harness-compatibility
Source: https://github.com/RatnaAtika/Indonesian-ASR-11-Class-Dataset/tree/main/.agents/skills/agent-harness-compatibility
Command: npx skills add https://github.com/RatnaAtika/Indonesian-ASR-11-Class-Dataset --skill agent-harness-compatibility-ratnaatika

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Each AI agent harness (Codex CLI, Pi, Cursor, Claude Code, Aider, OpenCode, Continue, Cline, Roo) discovers skills differently, forcing developers to fork skill content per tool. This Skill maps each harness to its expected install path and manifest format so one canonical SKILL.md serves every harness without duplication. ## Core Features & Use Cases - Harness mapping table: Documents the skills directory, manifest format, and SKILL.md compatibility for nine common agent harnesses plus a generic fallback. - Adapter generation strategy: Defines symlink adapters for SKILL.md-native harnesses, .mdc wrappers for Cursor, flat markdown for Continue/Cline/Roo, and a concatenated CONVENTIONS.md for Aider. - Detection signals: Lists the filesystem and environment markers (e.g., ~/.codex/, .cursor/, .aider.conf.yml) that scripts/configure.sh inspects to pick the right adapter. - Use Case: You maintain a set of team skills and a teammate switches from Claude Code to Cursor. Run the configure script to generate a .cursor/rules/<skill>.mdc adapter that includes the canonical SKILL.md, with no content copying. ## Quick Start Ask the agent to configure this project's skills for the detected harness so the canonical SKILL.md files become discoverable without forking content.

Frequently Asked Questions about agent-harness-compatibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make one SKILL.md work across multiple AI agent harnesses?▼

Keep one canonical SKILL.md under .agents/skills/<skill>/ and generate adapters per harness. SKILL.md-native harnesses (Codex, Pi, Claude Code, OpenCode) get symlinks, while Cursor, Continue, Cline, Roo, and Aider get generated wrapper files that include the canonical content.

How do I add skills to Cursor from a SKILL.md file?▼

Create a .cursor/rules/<skill>.mdc adapter with frontmatter containing the description, globs, and alwaysApply fields, then an @include line pointing to the canonical SKILL.md. Leave alwaysApply false for most skills to preserve context budget.

Does Aider support SKILL.md skill folders natively?▼

No, Aider does not load multi-file skill folders. The adapter generates a single concatenated markdown file (e.g., .aider/grand-skills.md) and you add it via the read: list in .aider.conf.yml.

Which agent harnesses read SKILL.md frontmatter directly?▼

Codex CLI, Pi, Claude Code, and OpenCode read SKILL.md frontmatter (name and description) directly, so a symlinked directory is sufficient. Cursor, Aider, Continue, Cline, and Roo require generated adapter files instead.

Why is my skill installed but ignored by the agent harness?▼

The harness likely expects a different manifest format or install path than what was provided. Check the detection signals (e.g., .cursor/, .claude/, .aider.conf.yml) and regenerate the matching adapter rather than copying the SKILL.md content.

Will the configure script overwrite my hand-written rule files?▼

No. The hard rules forbid auto-overwriting existing .mdc, .md, or CONVENTIONS.md files written by hand. Smart-sync behavior skips identical files, keeps diverged ones, and only upgrades older generated versions.

Related Skills

Explore More Software Engineering Skills→
jakubbartnikjakubbartnik

hermes-agent-skill-authoring

Author and validate in-repo SKILL.md files following Hermes Agent conventions.

Community
Intermediate
autonomous-aiautonomous-ai
465

hello

Prints a greeting message from the Starter harness workspace directory.

Official
Basic
jcdendritejcdendrite
4

skill-review

Audit Claude Code SKILL.md files for trigger accuracy and frontmatter consistency.

Community
Advanced
madebywildmadebywild
12

harness-prompt

Generate CLAUDE.md, AGENTS.md, and copilot-instructions.md from a canonical system prompt.

Official
Intermediate