Skip to content

acedergren/agentic-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
    _                    _   _      _____         _
   /_\  __ _ ___ _ _  __| |_(_)__  |_   _|__  ___| |___
  / _ \/ _` / -_) ' \/ _|  _| / _|   | |/ _ \/ _ \ (_-<
 /_/ \_\__, \___|_||_\__|\__|_\__|   |_|\___/\___/_/__/
       |___/

Production-grade AI agent skills, workflows, and automation for Claude Code

License: MIT Skills Agents Claude Code Community Project

Independent Community Project — No official affiliation with Anthropic or the Claude Code team. Skills are designed for Claude Code but are community-created.

What This Is

A battle-tested collection of Claude Code skills, custom agents, hooks, and configuration templates that form a complete development workflow pipeline. Built from real production use across 276 sessions, 435 commits, and 1,700+ passing tests.

The core pipeline takes you from requirements to merged PR:

/prd → /prd --to-plan → /orchestrate → agents use /implement → /review-all → /health-check → PR

Packages

Package What it includes
agentic-tools (this repo) Everything — all skills, agents, hooks, configs
team-pipeline Pipeline skills + agents only — for agent team orchestration
# Install everything
npx agentic-tools init

# Install just the pipeline
npx @acedergren/team-pipeline init

Quick Start

Via npx (recommended)

# Install into current project
npx agentic-tools init

# Install into a specific project
npx agentic-tools init ./my-project

# See what's included
npx agentic-tools list

Via git clone

git clone https://github.com/acedergren/agentic-tools.git
cd agentic-tools
./install.sh /path/to/your/project

This copies skills to .claude/skills/, agents to .claude/agents/, and hook examples to .claude/hooks/.

Install Individual Skills

# Copy a single skill from a cloned repo
cp -r skills/implement /path/to/project/.claude/skills/

# Or symlink for development
ln -s $(pwd)/skills/implement /path/to/project/.claude/skills/

Try It

# In your project with Claude Code:
/implement add validation to the user signup endpoint
/tdd add rate limiting to POST /api/search
/bugfix "TypeError: Cannot read property 'userId' of undefined"
/migrate "@old/pkg/utils → @new/pkg/core"
/health-check
/review-all
/prod-readiness

Skills

Development Pipeline

These skills chain together into a full implementation workflow.

Skill What It Does Key Feature
/implement End-to-end feature pipeline Pre-flight → TDD → scope guard → commit
/tdd Test-driven development cycle Mock bootstrap phase catches wiring issues early
/write-tests Add tests to existing code Module-type-aware mock strategy selection
/quality-commit Quality gates + commit Lint, typecheck, test, then commit
/bugfix Autonomous bug fix pipeline Evidence → hypothesis → minimal fix → verify → commit, no hand-holding
/migrate Codebase migration orchestrator Dedup check → scripted bulk sed → typecheck → residual scan → commit

Review & Quality

Skill What It Does Key Feature
/review-all Parallel multi-reviewer pipeline Security + API audit + scope check agents
/health-check Full codebase diagnostic 7+ gates: types, tests, lint, security, dead code
/api-audit Route-to-type contract validation Finds auth gaps, missing schemas, type drift
/doc-sync Documentation drift detection Compares docs against actual codebase state
/prod-readiness 5-agent production readiness review Security + test coverage + perf + observability + code quality → prioritized report

Planning & Orchestration

Skill What It Does Key Feature
/prd PRD creation with validation gates 10-gate validation checklist, --to-plan mode
/orchestrate Multi-agent team coordination Wave-based execution, heartbeat monitoring
/phase-kickoff Phase scaffolding Branch + test shells + roadmap entry

Content & Utilities

Skill What It Does Key Feature
/humanizer Remove AI writing patterns Diagnostic framework + voice injection
/firecrawl Web scraping CLI Parallel scraping, clean markdown output
/shadcn-svelte shadcn-svelte architecture Tailwind v4.1 patterns, library selection
/tanstack-query TanStack Query v5 patterns Migration gotchas, performance pitfalls
/turborepo Monorepo architecture Build optimization, workspace patterns
/refactor-module Terraform module extraction Decision framework for when to extract
/oracle-idcs-better-auth-setup Oracle + IDCS auth setup Routes setup work across shared Better Auth foundations
/fastify-better-auth-bridge Fastify Better Auth bridge Web Request forwarding, decorators, and org-context patching
/oracle-idcs-org-provisioning IDCS org provisioning Group gating, tenant-org resolution, MERGE INTO upserts

Agents

Custom agents for specialized tasks. Use with Claude Code's Task tool.

Agent Model Purpose
mock-debugger Sonnet Diagnoses Vitest mock wiring failures — 6 anti-pattern checklist
security-reviewer Opus OWASP Top 10 review with file:line references

Using Agents

Agents are automatically available when placed in .claude/agents/. Claude Code uses them via the Task tool:

# In Claude Code, the /review-all skill automatically spawns the security-reviewer agent
# Or reference directly: "Use the mock-debugger agent to diagnose why my tests fail"

Hooks

Pre-built automation that runs on Claude Code tool events. See claude/hooks/README.md for full documentation.

Examples (5 production-ready)

Hook Trigger What It Does
commit-preflight.sh Pre-Bash (git commit) Lint + typecheck staged files
security-scan.sh Pre-Bash (git push) Semgrep security scan
cost-tracker.sh Post-Bash Track cloud resource costs
session-summary.sh Session end Log session activity
file-backup.sh Pre-Edit Backup files before editing

Templates (4 starters)

Quick-start templates for building your own hooks: bash-pre.sh, edit-pre.sh, session-start.sh, user-prompt-submit.sh.


Configuration

User-Level Permissions (claude/settings/)

Global permissions covering 400+ commands across 30+ categories:

  • Languages: Node.js, Python, Go, Rust, Java, Ruby, PHP, C/C++, Swift
  • Cloud: AWS, GCP, Azure, OCI, Cloudflare
  • DevOps: Docker, Kubernetes, Terraform, Ansible
  • Testing: Vitest, Jest, Playwright, Cypress
  • Security: Semgrep, Snyk, Trivy
# Install global permissions
cp claude/settings/user-level/config.json ~/.config/claude/config.json

Git Workflows (git-workflow/)

  • 3 workflow strategies (Trunk-Based, GitHub Flow, GitFlow)
  • 8 commit templates (Conventional Commits)
  • 6 PR templates
  • Branch naming conventions

The Pipeline

How the skills work together for a complete feature lifecycle:

┌─────────────────────────────────────────────────────────────┐
│                    PLANNING PHASE                           │
│                                                             │
│  /prd ──────────► PRD.md ──────────► /prd --to-plan        │
│  (interactive      (validated         (generates            │
│   discovery)       requirements)       task plan)           │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                   EXECUTION PHASE                           │
│                                                             │
│  /orchestrate ──► spawn agent team ──► each agent runs:     │
│  (coordinates      (haiku/sonnet       /implement           │
│   waves)            per task)           (full TDD pipeline)  │
│                                                             │
│  /implement phases:                                         │
│    0. Pre-flight (git clean? types compile? tests green?)   │
│    1. Understand & Plan                                     │
│    2. Bootstrap Mock (1 test to validate wiring)            │
│    3. Red — write failing tests                             │
│    4. Green — minimum implementation                        │
│    5. Scope Guard (revert out-of-scope changes)             │
│    6. Full Suite + Quality Gates                            │
│    7. Commit                                                │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                    REVIEW PHASE                             │
│                                                             │
│  /review-all ──► parallel agents:                           │
│                  • security-reviewer (OWASP Top 10)         │
│                  • API route auditor (schema coverage)      │
│                  • scope auditor (drift detection)          │
│                                                             │
│  /health-check ► types ✓ tests ✓ lint ✓ security ✓         │
│                  dead code ✓ circular deps ✓ audit ✓        │
│                                                             │
│  Verdict: READY TO MERGE / NEEDS FIXES / NEEDS DISCUSSION  │
└─────────────────────────────────────────────────────────────┘

Customization

These skills are designed to be adapted to your project. Common customizations:

Project-Specific Paths

Update file paths in skills to match your project structure:

# In skills/health-check/SKILL.md, update workspace paths:

cd apps/api && npx tsc --noEmit → cd src && npx tsc --noEmit

Additional Review Agents

Add project-specific reviewers to /review-all:

# In skills/review-all/SKILL.md, add to the agent table:

| **DB Reviewer** | `oracle-query-reviewer` (custom) | Changed SQL files | Bind params, atomic ops |

Custom Quality Gates

Extend /health-check with project-specific checks:

# Add to skills/health-check/SKILL.md:

### 8. OpenAPI Lint

npx spectral lint openapi.json --ruleset .spectral.yaml

Repository Structure

agentic-tools/
├── README.md
├── install.sh                        # One-command installer
├── LICENSE
│
├── skills/                           # Claude Code skills
│   ├── implement/SKILL.md            # Full TDD pipeline
│   ├── tdd/SKILL.md                  # Test-driven development
│   ├── write-tests/SKILL.md          # Test generation
│   ├── bugfix/SKILL.md               # Autonomous bug fix pipeline
│   ├── migrate/SKILL.md              # Bulk import/module migration
│   ├── review-all/SKILL.md           # Parallel review pipeline
│   ├── health-check/SKILL.md         # Codebase diagnostics
│   ├── prod-readiness/SKILL.md       # 5-agent pre-release review
│   ├── api-audit/SKILL.md            # Route-type contract audit
│   ├── doc-sync/SKILL.md             # Documentation drift
│   ├── phase-kickoff/SKILL.md        # Phase scaffolding
│   ├── prd/                          # PRD management
│   │   ├── SKILL.md
│   │   ├── template.md
│   │   ├── validation.md
│   │   └── drift-prevention.md
│   ├── orchestrate/                  # Multi-agent coordination
│   │   ├── SKILL.md
│   │   ├── wave-template.md
│   │   ├── agent-roles.md
│   │   └── headless-runner.md
│   ├── quality-commit/SKILL.md       # Quality gates + commit
│   ├── humanizer/                    # AI pattern removal
│   ├── firecrawl/                    # Web scraping
│   ├── shadcn-svelte-skill/          # shadcn-svelte patterns
│   ├── tanstack-query/               # TanStack Query v5
│   ├── turborepo/                    # Monorepo patterns
│   └── refactor-module/              # Terraform extraction
│   ├── oracle-idcs-better-auth-setup/   # Oracle + IDCS + Better Auth router
│   ├── fastify-better-auth-bridge/      # Fastify session bridge patterns
│   └── oracle-idcs-org-provisioning/    # IDCS org membership provisioning
│
├── claude/
│   ├── agents/                       # Custom agent definitions
│   │   ├── mock-debugger.md
│   │   └── security-reviewer.md
│   ├── hooks/                        # Hook scripts + templates
│   │   ├── README.md
│   │   ├── examples/                 # 5 production-ready hooks
│   │   └── hook-templates/           # 4 starter templates
│   └── settings/                     # Permission configs
│       ├── user-level/config.json    # 400+ command permissions
│       └── templates/                # Platform-specific configs
│
└── git-workflow/                     # Git strategy guides
    ├── workflows/                    # 3 workflow strategies
    ├── commit-templates/             # 8 conventional commit templates
    ├── pr-templates/                 # 6 PR templates
    └── branch-naming/                # Naming conventions

Contributing

Found a missing pattern or have a battle-tested skill? PRs welcome.

  1. Follow the existing skill format (YAML frontmatter + markdown body)
  2. Include anti-patterns with WHY explanations
  3. Keep core content under 300 lines (use progressive disclosure with reference files)
  4. Test the skill in a real project before submitting

See CONTRIBUTING.md for full guidelines.


License

MIT License — see LICENSE for details.

Legal Disclaimer: This is an independent community project with no official affiliation, partnership, or endorsement from Anthropic or any other mentioned products or services. References indicate compatibility, not affiliation.


Last Updated: February 2026 Claude Code Version: Compatible with latest CLI

About

Comprehensive toolkit for AI-assisted development: Claude Code permissions (400+ tools), Git workflows, and automation hooks

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages