# Adapters

> Generates agent-specific configuration files from the unified ContextOS format. One internal system, multiple output formats for Claude, Gemini, Copilot, Cursor, Aider, Continue, OpenHands, and others.

- Skill: `kok-o/adapters-2` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add kok-o/adapters-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kok-o/adapters-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kok-o (https://skillmd.com/u/kok-o)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kok-o/adapters-2

---


# agent-adapters

## Overview

Unified cross-agent configuration engine. Translates single ContextOS source rules into optimized native formats for Claude Code (CLAUDE.md), Gemini (.agents/skills), Cursor (.cursorrules, .cursor/rules/*.mdc), GitHub Copilot, Zed, Aider, and Continue.

## When to Use

Activate when configuring, synchronizing, or exporting agent rules and skills across multiple IDEs and AI programming assistants.

## Rules & Patterns

ContextOS is agent-agnostic. This skill generates the right config format for any AI agent.

## Supported Agents

| Agent | Config File | Format |
| --- | --- | --- |
| **Gemini** | `.agents/AGENTS.md` + `.agents/skills/` | Markdown + YAML skills |
| **Claude Code** | `CLAUDE.md` | Single markdown file |
| **GitHub Copilot / Codex** | `AGENTS.md` (root) | Markdown |
| **Cursor** | `.cursorrules` | Plain text rules |
| **Aider** | `.aider.conf.yml` | YAML config |
| **Continue** | `.continuerules` | Markdown rules |
| **OpenHands** | `openhands.json` | JSON config |
| **Roo Code** | `.roo/` | Directory with rules |
| **Windsurf** | `.windsurfrules` | Plain text rules |

## Generation Command

`ctx adapt [agent]` — Generate config for a specific agent.

`ctx adapt all` — Generate configs for all supported agents.

## Adapter Logic

### For Claude Code (`CLAUDE.md`)

Compile into a single markdown file:

1. Project overview from `docs/PRD.md` (summary only)
2. Architecture summary from `docs/ARCHITECTURE.md`
3. Coding rules from loaded skills
4. Active Decision Records
5. Current tasks from `docs/TASKS.md`

### For Gemini (`.agents/AGENTS.md`)

Already native format. Just ensure:

1. `AGENTS.md` references the skill directory
2. Skills have proper SKILL.md with frontmatter
3. Context Manager rules are in AGENTS.md

### For Cursor (`.cursorrules`)

Compile into a flat text file:

1. Project context (condensed)
2. Coding style rules
3. Framework-specific instructions
4. Anti-patterns to avoid

### For Aider (`.aider.conf.yml`)

```yaml
read:
  - docs/ARCHITECTURE.md
  - docs/API.md
  - docs/PROJECT_GRAPH.md
conventions:
  - {{coding rules from skills}}
```

## Sync Rules

- Adapters read from the canonical ContextOS documents
- Never edit adapter output files directly
- Re-run `ctx adapt` after any document change
- Each adapter file includes a header: `# Generated by ContextOS — do not edit directly`


## Code Examples

See `EXAMPLES.md` for detailed code examples.

## Validation Checklist

What to verify during the review phase before completing the task.

## Common Mistakes

Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.

## Integration Notes

How this skill interacts with other skills.