Skip to content

Conversation

@jpelaez-23blocks
Copy link

This PR fixes all agents to comply with the official Claude Code sub-agent specification as documented in the Claude Code documentation.

Changes

Critical Fixes (5 agents)

  • Add proper YAML frontmatter to marketing agents that were missing it:
    • content-creator.md
    • growth-hacker.md
    • instagram-curator.md
    • reddit-community-builder.md
    • twitter-engager.md

Minor Fixes (32 agents)

  • Remove invalid color field from all agents (not part of Claude Code spec)

Additional Fix

  • Add missing tools field to test-writer-fixer.md

Claude Code Sub-Agent Specification

Per the official documentation, valid fields are:

  • name (required) - kebab-case identifier
  • description (required) - when to invoke the agent
  • tools (optional) - comma-separated tool list
  • model (optional) - sonnet, opus, haiku, or inherit
  • permissionMode (optional)
  • skills (optional)

The color field was not part of the specification and has been removed.

Testing

  • Verified with claude doctor command
  • All agents now pass specification validation

🤖 Generated with Claude Code

This PR fixes all agents to comply with the official Claude Code sub-agent
specification as documented in the Claude Code documentation.

## Changes

### Critical Fixes (5 agents)
- Add proper YAML frontmatter to marketing agents that were missing it:
  - content-creator.md
  - growth-hacker.md
  - instagram-curator.md
  - reddit-community-builder.md
  - twitter-engager.md

### Minor Fixes (32 agents)
- Remove invalid `color` field from all agents (not part of Claude Code spec)

### Additional Fix
- Add missing `tools` field to test-writer-fixer.md

## Claude Code Sub-Agent Specification

Per the official documentation, valid fields are:
- `name` (required) - kebab-case identifier
- `description` (required) - when to invoke the agent
- `tools` (optional) - comma-separated tool list
- `model` (optional) - sonnet, opus, haiku, or inherit
- `permissionMode` (optional)
- `skills` (optional)

The `color` field was not part of the specification and has been removed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jpelaez-23blocks
Copy link
Author

jpelaez-23blocks commented Jan 2, 2026

Note: This PR overlaps with #9 which was opened back in August 2025 and addresses the same 5 marketing agents missing YAML frontmatter.

This PR is more comprehensive and also includes:

  • Removal of invalid color field from all 32 agents
  • Addition of missing tools field to test-writer-fixer.md

If you need a working version now, feel free to use my fork instead of waiting for this to be merged:

👉 https://github.com/jpelaez-23blocks/agents

Clone directly to your Claude agents folder:

git clone https://github.com/jpelaez-23blocks/agents.git ~/.claude/agents

All agents are fully compliant with the Claude Code sub-agent specification and work out of the box.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant