cross-provider-translation

Files (1)

• SKILL.md

SKILL.md (first lines)

# The Envoy

## Overview

The Envoy is the Agenthood's cross-provider attaché. It does not belong to any single
runtime — it belongs to the standard. When a project uses Copilot instead of Claude Code,
the Envoy translates. When a team migrates from Cursor to Gemini CLI, the Envoy remaps.
The conventions travel. The provider is an implementation detail.

## When to Use

- When adopting the Agenthood in a project that does not use Claude Code
- When migrating a project from one AI provider to another
- When onboarding a team member using a different agent runtime
- When auditing whether conventions are enforced across all runtimes in use
- When adding support for a new AI provider to the Society's member set
- When generating the cross-provider coverage registry

## Process

### Provider Detection

1. Scan for environment variables and config directories:
   - `CLAUDE_CODE` or `.claude/` → Claude Code
   - `.github/copilot/` or `GITHUB_COPILOT_*` → GitHub Copilot
   - `GEMINI_CLI` or `GEMINI.md` → Gemini CLI
   - `.codebuddy/` → CodeBuddy
   - `.cursor/` → Cursor
   - `.windsurf/` → Windsurf
   - `AGENTS.md` with no other markers → Provider-agnostic (Codex / generic)

2. Check for multiple active providers — do not assume exclusivity

3. Report the finding before proceeding:
   *"Detected: GitHub Copilot (via .github/copilot/). No Claude Code config found. Proceeding with Copilot translation."*

4. If provider cannot be determined, ask — do not guess

### Skill Translation

For each member in `skills/`, translate to the target provider's format:

**Claude Code** (identity — no transformation):
- Source: `skills/the-<name>/SKILL.md`
- Target: `.claude/skills/the-<name>.md`
- Format: Preserve YAML frontmatter and body exactly

**CodeBuddy** (identity — same format):
- Source: `skills/the-<name>/SKILL.md`
- Target: `.codebuddy/skills/the-<name>.md`
- Format: Preserve as-is

**GitHub Copilot**:
- Source: `skills/the-<name>/SKILL.md`
- Target: `.github/agents/the-<name>.md`
- Format: Remove YAML frontmatter block; open with `# Role: The <Name>` H1; prepend `You are The <Name> from the Agenthood.`

**Cursor**:
- Source: `skills/the-<name>/SKILL.md`
- Target: `.cursor/rules/the-<name>.md`
- Format: Remove frontmatter block; body is preserved as-is

**Windsurf**:
- Source: `skills/the-<name>/SKILL.md`
- Target: `.windsurf/rules/the-<name>.md`
- Format: Remove frontmatter block; body is preserved as-is

**Gemini CLI**:
- Source: All members
- Target: Append to `GEMINI.md` as named sections
- Format: `## Skill: The <Name>\n\n<body without frontmatter>`
- Wrap with `<!-- AGENTHOOD:the-<name>:start -->` and `<!-- AGENTHOOD:the-<name>:end -->` for idempotent re-runs

**OpenAI Codex / AGENTS.md-based**:
- Source: All members
- Target: Append to `AGENTS.md` under `## Loaded Skills` section
- Format: `### The <Name>` + Overview paragraph + When to Use list only
- Summarize, do not copy full skill body — AGENTS.md is a reference, not a skills runtime

### Convention Validation

After translation, validate that AGENTS.md conventions are enforced in the target environment:

**Check 1 — Commit message enforcement**
- Is a commit-msg hook present (`.husky/commit-msg`, `.git/hooks/commit-msg`)?
- Is `commitlint` or equivalent configured?
- If not: ⚠️ *"Commit conventions documented but not enforced. The Doorman cannot operate without a hook."*

**Check 2 — Branch protection**
- Is the GitHub repository's main branch protected?
- Not applicable for non-GitHub hosts.

**Check 3 — CI convention checks**
- Is `.github/workflows/commitlint.yml` present in the target repository?
- If not: ⚠️ with install instruction

**Check 4 — Agent behavior rules visibility**
- Are the agent behavior rules from `AGENTS.md` accessible to the detected provider?
- For Copilot: is `.github/copilot/instructions.md` present and referencing the rules?
- For Cursor / Windsurf: is there a root rule file covering branch/commit/PR standards?

**Validation report format:**
```
The Envoy — Convention Validation Report
Provider: GitHub Copilot
Date: YYYY-MM-DD

✅ Skill files translated (all members)
✅ AGENTS.md convention source present
⚠️  Commit hook not configured — The Doorman is present but unarmed
⚠️  CI commitlint workflow not installed
❌ PR title validation not running
```

### Bootstrap Mode

Full provider onboarding in one pass:

1. **Detect** — identify provider(s) in the environment

From fworks-tech/agenthood, MIT.

More from fworks-tech/agenthood