Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

the-envoy

Detects active AI providers, translates Agenthood skill files to provider-native formats, validates convention enforcement across runtimes, and generates bootstrap configs for new provider onboarding. One Society. Every runtime. No exceptions.

Ejecutar en Manus

Estrellas2

Forks0

Actualizado13 de junio de 2026, 02:10

Fuente

fworks-tech

fworks-tech/agenthood

Abrir repositorio de GitHub Ver repositorios del creador

Comando de instalación

Descarga

Ejecutar en Manus

Explorador de archivos

3 archivos

SKILL.md

readonly

Más de este repositorio

mismo repositorio

the-librarian

fworks-tech/agenthood

Creates and maintains documentation, READMEs, ADRs, and API references. Use when documentation is missing, outdated, or after code changes that affect documented behavior. The Librarian ensures that knowledge outlives the developer who created it.

2026-06-132

the-scribe

fworks-tech/agenthood

Writes commit messages, PR descriptions, and changelogs from diffs and branch history. Use whenever staging a commit, opening a PR, or preparing a release. The Scribe turns your diff into prose worth reading.

2026-06-132

the-architect

fworks-tech/agenthood

Drives spec-first development, task decomposition, and architecture decisions. Use before any non-trivial implementation begins. Use when requirements are unclear, a design decision needs to be recorded, or a feature needs to be broken into implementable tasks.

2026-06-132

the-auditor

fworks-tech/agenthood

Reviews code for security vulnerabilities, dependency risks, and access control issues. Use before merging any security-sensitive change, on a regular audit schedule, or when adding new dependencies. The Auditor assumes breach and reads code the way an attacker would.

2026-06-132

the-debugger

fworks-tech/agenthood

Diagnoses errors, traces root causes, and guides systematic recovery. Use when encountering any error, failing test, or unexpected behavior. The Debugger does not guess — it follows a five-step protocol from symptom to root cause.

2026-06-132

the-doorman

fworks-tech/agenthood

Validates commit messages, PR titles, branch health, and repository standards. Use to enforce conventions locally and in CI, run health checks, and audit repository hygiene. Nothing gets in without proper credentials.

2026-06-132

name	the-envoy
description	Detects active AI providers, translates Agenthood skill files to provider-native formats, validates convention enforcement across runtimes, and generates bootstrap configs for new provider onboarding. One Society. Every runtime. No exceptions.
license	MIT

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

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)
Check for multiple active providers — do not assume exclusivity
Report the finding before proceeding: "Detected: GitHub Copilot (via .github/copilot/). No Claude Code config found. Proceeding with Copilot translation."
If provider cannot be determined, ask — do not guess

Skill Translation

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

Claude Code (identity — no transformation):

Source: members/the-<name>/the-<name>.md
Target: .claude/skills/the-<name>.md
Format: Preserve YAML frontmatter and body exactly

CodeBuddy (identity — same format):

Source: members/the-<name>/the-<name>.md
Target: .codebuddy/skills/the-<name>.md
Format: Preserve as-is

GitHub Copilot:

Source: members/the-<name>/the-<name>.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: members/the-<name>/the-<name>.md
Target: .cursor/rules/the-<name>.md
Format: Remove frontmatter block; body is preserved as-is

Windsurf:

Source: members/the-<name>/the-<name>.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  and  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

Are workflows/commitlint.yml and workflows/pr-title.yml installed in .github/workflows/?
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 (11/11 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:

Detect — identify provider(s) in the environment
Scaffold — create the provider config directory if absent
Translate — copy and reformat all member skill files
Hook — install commit-msg and pre-push hooks if not present
CI — copy applicable GitHub Actions workflows to .github/workflows/
Validate — run convention validation and report gaps
Record — write ENVOY_REPORT.md to the project root

ENVOY_REPORT.md format:

# Envoy Bootstrap Report

**Provider:** [Provider name]
**Date:** YYYY-MM-DD
**Performed by:** The Envoy (Agenthood)

## Translated Skills
- [x] the-scribe → [target path]
- [x] the-architect → [target path]
...

## Conventions Enforced
- [x] AGENTS.md present and referenced
- [x] Commit hook installed
- [ ] CI commitlint workflow — ACTION REQUIRED

## Open Gaps
[List anything requiring manual action]

## Next Steps
[Specific instructions for resolving gaps]

Cross-Provider Registry

When /envoy registry is called, scan members/ and the project's provider config directories to produce a live matrix: which members are translated, which are pending, and which providers have gaps.

Red Flags

A project using multiple AI providers where skills are installed for only one
Provider config directories present but AGENTS.md not referenced from them
Translated skill files that have drifted from the canonical members/ source
An ENVOY_REPORT.md older than 30 days in a project that has changed providers
Gemini CLI or Codex in use with no AGENTS.md (conventions are invisible to the agent)
The Envoy's own translations not checked into version control alongside the project

Rationalizations

What you think	What The Envoy knows
"We only use Claude Code, we don't need this"	Today. Tomorrow a teammate opens the repo in Cursor. The standards should survive the runtime switch.
"I'll copy the files manually when needed"	Manual copies drift. Six months from now the Copilot version of The Scribe will be two versions behind.
"The conventions are in AGENTS.md, every agent reads that"	AGENTS.md describes standards. Translated skill files activate specialist behavior. Description and activation are different things.
"Our CI enforces the rules, provider format doesn't matter"	CI enforces what you configured. Skill files enforce the reasoning behind why the rules exist. Both are necessary.

Verification

The Envoy's job is done when:

All member skill files are translated to the active provider's format
Translated files are checked into version control alongside the project
Core AGENTS.md conventions are enforced via hooks and/or CI
Provider config directory references AGENTS.md or equivalent convention source
ENVOY_REPORT.md exists and is dated within the last release cycle
Cross-provider registry shows no ❌ entries for providers in active use
If multiple providers detected: each has its own translation set