Repository navigation
Add Team Avatar skills plugin for Claude Code and Codex - #54
Closed
tmcfarlane wants to merge 1 commit into
Closed
tmcfarlane wants to merge 1 commit into
tmcfarlane wants to merge 1 commit into
Conversation
Team Avatar becomes a universal set of principal-level engineering skills, with each discipline owned by a character from the show. avatar-mode routes the work; the plugin installs from this repo as a Claude Code marketplace and a Codex marketplace. Adds 15 skills, 8 character agents, both marketplace manifests, a zero-dependency validator wired into CI, and captured evidence of the plugin loading. The Cursor install is unchanged. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The validator misses malformed frontmatter and broken routing references, and rejects valid CRLF frontmatter.
3 open issues
What changed in this PR
Extends the existing Cursor config pack with a shared Team Avatar plugin for Claude Code and Codex, leaving the Cursor installation unchanged.
Changes:
- Adds 15 engineering skills, eight character agents, and runtime guidance.
- Adds plugin manifests, marketplaces, and installation instructions.
- Adds validation, CI integration, and recorded verification evidence.
| File | Description |
|---|---|
| scripts/validate-team-avatar.mjs | Validates plugin content and metadata. |
| README.md | Introduces plugin installation. |
| plugins/team-avatar/skills/yip-yip/SKILL.md | Defines PR shipping workflow. |
| plugins/team-avatar/skills/white-lotus/SKILL.md | Defines teaching workflow. |
| plugins/team-avatar/skills/war-room/SKILL.md | Defines architecture decision workflow. |
| plugins/team-avatar/skills/tea-time/SKILL.md | Defines technical writing guidance. |
| plugins/team-avatar/skills/steady-flight/SKILL.md | Defines plan execution workflow. |
| plugins/team-avatar/skills/seismic-sense/SKILL.md | Defines read-only investigation. |
| plugins/team-avatar/skills/scouting-flight/SKILL.md | Defines prototype workflow. |
| plugins/team-avatar/skills/redemption-arc/SKILL.md | Defines incident response workflow. |
| plugins/team-avatar/skills/push-and-pull/SKILL.md | Defines testing discipline. |
| plugins/team-avatar/skills/master-plan/SKILL.md | Defines planning workflow. |
| plugins/team-avatar/skills/healing-water/SKILL.md | Defines debugging workflow. |
| plugins/team-avatar/skills/four-elements/SKILL.md | Establishes shared engineering principles. |
| plugins/team-avatar/skills/earth-rumble/SKILL.md | Defines code review workflow. |
| plugins/team-avatar/skills/breath-of-fire/SKILL.md | Defines performance investigation. |
| plugins/team-avatar/skills/avatar-mode/SKILL.md | Routes tasks and coordinates specialists. |
| plugins/team-avatar/skills/avatar-mode/references/codex.md | Maps workflows to Codex tools. |
| plugins/team-avatar/README.md | Documents roster, installation, and development. |
| plugins/team-avatar/agents/zuko.md | Adds performance and incident specialist. |
| plugins/team-avatar/agents/toph.md | Adds investigation and review specialist. |
| plugins/team-avatar/agents/sokka.md | Adds planning specialist. |
| plugins/team-avatar/agents/momo.md | Adds prototyping specialist. |
| plugins/team-avatar/agents/katara.md | Adds debugging and testing specialist. |
| plugins/team-avatar/agents/iroh.md | Adds writing and teaching specialist. |
| plugins/team-avatar/agents/appa.md | Adds execution and shipping specialist. |
| plugins/team-avatar/agents/aang.md | Adds orchestration agent. |
| plugins/team-avatar/.codex-plugin/plugin.json | Declares Codex plugin metadata. |
| plugins/team-avatar/.claude-plugin/plugin.json | Declares Claude Code plugin metadata. |
| docs/evidence/team-avatar/validator-negative.txt | Records rejected validation defects. |
| docs/evidence/team-avatar/codex-skills.txt | Records discovered skills. |
| docs/evidence/team-avatar/codex-routing.txt | Records performance-task routing. |
| docs/evidence/team-avatar/codex-install.txt | Records Codex installation. |
| docs/evidence/team-avatar/claude-code.txt | Records validation and installation. |
| .github/workflows/validate-team-avatar.yml | Runs plugin validation in CI. |
| .claude-plugin/marketplace.json | Registers Claude Code marketplace entry. |
| .agents/plugins/marketplace.json | Registers Codex marketplace entry. |
Review effort: Balanced
|
|
||
| function frontmatter(file) { | ||
| const text = readFileSync(file, "utf8"); | ||
| const m = text.match(/^---\n([\s\S]*?)\n---\n/); |
Comment on lines
+34
to
+36
| for (const line of m[1].split("\n")) { | ||
| const kv = line.match(/^([a-z_-]+):\s*(.*)$/); | ||
| if (kv) fields[kv[1]] = kv[2].trim(); |
Comment on lines
+84
to
+85
| // Only names after a routing verb count, so code spans like `git log -S` are not mistaken for skills. | ||
| const ROUTE = /(?:Load|Run|run|Use|use|with|to|via|follows|Hand to|hand to|see|See|in) `([a-z0-9]+(?:-[a-z0-9]+)+)`/g; |
This was referenced Oct 18, 2026
Owner
Author
|
Superseded by #57, the Team Avatar v1.0.0 release, which carries every commit from this PR. The branch is kept. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Trent
Before: Team Avatar was a Cursor-only config pack. Its agents leaned on 21 borrowed third-party skills, and nothing loaded in Claude Code or Codex.
After: This repo is also a plugin marketplace for Claude Code and Codex. Installing
team-avatargives 15 original principal-level engineering skills and 8 character agents. Each discipline belongs to the character whose personality fits it, andavatar-mode(Aang) routes every task to the right one.avatar-mode,four-elementsmaster-plan,war-roomseismic-sense,earth-rumblehealing-water,push-and-pullbreath-of-fire,redemption-arctea-time,white-lotussteady-flight,yip-yipscouting-flightThe approach follows pstack's poteto mode: read before you claim, name the data shape first, ship the smallest change the evidence justifies, and prove it on the real artifact.
four-elementsgroups those principles by element (Air subtracts, Water adapts, Earth holds, Fire drives).How. The plugin lives in
plugins/team-avatarwith a.claude-pluginand a.codex-pluginmanifest over one sharedskills/tree. The repo root gains.claude-plugin/marketplace.jsonand.agents/plugins/marketplace.json. Codex readsskills/avatar-mode/references/codex.mdfor its tool and subagent equivalents.scripts/validate-team-avatar.mjschecks frontmatter, cross-skill references, links, manifest versions, and the no-long-dash rule, and a new workflow runs it on PRs. The Cursor installer, agents, and old skills are untouched.Verification
Codex 0.159.0 loads all 15 skills from the local marketplace, and
$avatar-moderoutes a perf report to Zuko andbreath-of-fire:Claude Code 2.1.296 validates the plugin and marketplace and lists the plugin as installed and enabled. The validator passes, and catches 4 defects injected into a scratch copy:
Not yet verified: a live Claude Code session invoking the skills. The
claudeCLI sign-in on the dev machine had expired, soclaude -pcould not run. Raw transcripts are indocs/evidence/team-avatar/.Follow-ups (not in this PR)
🤖 Generated with Claude Code