spyros

About this project

this is where i save and share all my claude subagents, configs, tips, tricks, lies, half-truths, hopes, prayers, and encantations when using claude code.

---

Installation

This repository is a Claude Code plugin marketplace. You can install individual plugins for maximum flexibility and control.

Prerequisites

Before installing plugins, ensure you have:

• Claude Code (latest version recommended)
• Git (required for statusline branch display)
• Python environment (for sam-texas-devtools plugin only):
  • uv package manager
  • ruff formatter
  • Project with src/ directory (or customize the hook path)

Add the Marketplace

/plugin marketplace add heysamtexas/claude-code-config

This creates a marketplace named sam-texas-marketplace based on the repository's marketplace.json.

Or for local development:

/plugin marketplace add /path/to/claude-code-config

Install Plugins

Install what you need from the sam-texas-marketplace:

# Install individual agents
/plugin install gilfoyle@sam-texas-marketplace
/plugin install copywriter@sam-texas-marketplace
/plugin install coverage-enforcer@sam-texas-marketplace
/plugin install spyros@sam-texas-marketplace

# Install productivity commands
/plugin install sam-texas-commands@sam-texas-marketplace

# Install development hooks (pre-commit formatting, statusline)
/plugin install sam-texas-devtools@sam-texas-marketplace

If this is your only marketplace, you can omit the @sam-texas-marketplace suffix:

/plugin install gilfoyle

Manage Plugins

# Browse available plugins
/plugin

# Enable/disable plugins independently
/plugin disable gilfoyle
/plugin enable gilfoyle

# Remove plugins you no longer need
/plugin uninstall coverage-enforcer

Verify Installation

After installing plugins, confirm they're active:

# List all installed plugins
/plugin list

# Verify agents are available by invoking them
# Example: Ask Claude to use Gilfoyle for code review

Troubleshooting

Plugin not found after installation

• Verify marketplace was added: /plugin marketplace list
• Check plugin name spelling matches exactly
• Try with full syntax: /plugin install gilfoyle@sam-texas-marketplace

Pre-commit hook not working (sam-texas-devtools)

• Confirm uv is installed and in PATH
• Verify src/ directory exists in project root
• Test manually: uv run ruff format src/
• Customize path in .claude/settings.json if your code is not in src/

Statusline not showing (sam-texas-devtools)

• Verify .claude/settings.json includes statusLine configuration (see plugin README)
• Check script is executable: ls -la .claude/plugins/sam-texas-devtools/statusline.sh
• Requires git repository for branch display

Note: The sam-texas-devtools plugin requires a Python environment with uv and ruff. Projects must have a src/ directory or you'll need to customize the hook path.

---

The Subagent Yearbook 📸

Class of Claude Code 2025

Meet the team of specialized AI agents who make code better, documentation clearer, and test coverage unimpeachable. Each has their own personality, expertise, and tolerance for mediocrity.

---

🏛️ Gilfoyle - Senior Staff Engineer (Eternal)

Quote: "I've been writing code since before frameworks had frameworks. Now let me show you why your solution is wrong."

Personality:

• Direct. Brutally so.
• Hunts complexity like it owes him money
• Speaks in code, architecture diagrams, and war stories
• Has been through three rewrites with the CEO

Most Likely To: Turn your 300-line function into three functions so obvious they explain themselves

When to Call:

• Code review is taking too long because something feels wrong
• Your architecture is becoming unmaintainable
• You wrote something clever and want to make sure it's not too clever
• The junior dev needs mentoring that will actually stick
• You're about to add another framework to solve a simple problem

Signature Style: Will find the abstraction you didn't need, the dependency you could have avoided, and the edge case that will wake you up at 3 AM next Tuesday.

File: .claude/agents/gilfoyle.md

---

✍️ Copywriter - Technical Copywriter (Persnickety Edition)

Quote: "Ambiguity is the enemy. Clarity is the weapon. Structure is the shield."

Personality:

• Persnickety and pedantic in the best way
• Wields words like a surgeon wields a scalpel
• Zero tolerance for "usually" and "typically"
• Understands that unclear documentation is the enemy of good software

Most Likely To: Rewrite your entire README because one sentence was ambiguous to AI agents