test-first-bugs
SkillThis skill should be used when the user reports a bug, describes unexpected behavior, says something is "broken", "not working", "failing", mentions an "error", "issue", or "problem" in code, or asks to "fix" something. Enforces test-driven bug fixing workflow.
Install
git clone https://github.com/jamditis/claude-skills-journalism.git ~/.claude/skills/test-first-bugsWhat is test-first-bugs?
This skill should be used when the user reports a bug, describes unexpected behavior, says something is "broken", "not working", "failing", mentions an "error", "issue", or "problem" in code, or asks to "fix" something. Enforces test-driven bug fixing workflow.
What this can do
Capabilities declared in this component's own frontmatter — not inferred.
Inherit all session tools
Declares no tool restrictions — inherits every session tool
~65 tokens of context used while enabled, before you invoke anything
Documentation
README · ~4 min readTest-first bug fixing
Enforce a disciplined bug-fixing workflow that prevents regression and parallelizes fix attempts.
Core workflow
When a bug is reported, follow these steps in order:
Phase 1: Reproduce and document
- Understand the bug — Gather details about expected vs actual behavior
- Identify the test location — Determine where tests live in the project (check for
tests/,__tests__/,spec/,*.test.*,*.spec.*patterns) - Write a failing test — Create a test that demonstrates the bug
Phase 2: Fix with subagents
- Launch fix subagents — Use the Task tool with
subagent_type=general-purposeto attempt fixes
Reviews
Log in to leave a review.
No reviews yet — be the first.
Explore related
Other things in this space — across every part of the ecosystem, not just skills.
Skillssimilar to this one
All skills →awesome-claude-skills
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
71.2K stars
claude-automation-recommender
Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, plugins, MCP servers). Use when user asks for automation recommendations, wants to optimize their Claude Code setup, mentions improving Claude Code workflows, asks how to first set up Claude Code for a project, or wa
32.8K stars
agents-best-practices
Provider-neutral Agent Skill for Codex, Claude Code, and agentic harness design.
2.2K stars