Agent skill
amplihack-expert
Comprehensive knowledge of amplihack framework architecture, patterns, and usage
Install this agent skill to your Project
npx add-skill https://github.com/rysweet/amplihack/tree/main/.claude/skills/amplihack-expert
SKILL.md
amplihack Expert Knowledge
What is amplihack?
Engineering system for coding CLIs (Claude, Copilot, Amplifier): 5 mechanisms, 23-step workflow, 30+ agents, 80+ skills. Core entry point: /dev <task> — unified task orchestrator with auto-classification, parallel workstream detection, and goal-seeking execution loop.
Quick Reference
Top Commands
| Command | Purpose | Use When |
|---|---|---|
| /dev | Orchestrate | Any non-trivial task |
| /analyze | Review | Check compliance |
| /fix | Fix errors | Common error patterns |
| /amplihack:ddd:* | Doc-driven dev | 10+ file features |
| /multitask | Parallel tasks | Sprint/batch work |
Top Agents
| Agent | Role |
|---|---|
| architect | Design |
| builder | Code |
| reviewer | Quality |
| tester | Tests |
Workflows
| Name | Steps |
|---|---|
| DEFAULT_WORKFLOW | 23 |
| INVESTIGATION | 6 |
| FIX | 3 |
Navigation Guide
Quick: SKILL.md | Architecture: reference.md | How-To: examples.md | Deep: all
Core Concepts
5 Mechanisms: Workflow (process), Command (entry), Skill (auto), Agent (delegate), Hook (runtime)
Composition: Commands → Workflows → Agents → Skills
Execution: /dev orchestrates — classifies task, detects parallel workstreams, executes via smart-orchestrator recipe, goal-seeking loop (3 rounds max)
Entry point: /dev <task> → dev-orchestrator skill → smart-orchestrator recipe → default-workflow recipe
dev-orchestrator Architecture
Entry point: /dev <task> or any non-trivial prompt
Routing:
- Q&A →
amplihack:core:analyzerresponds directly - Operations → bash (simple) or
amplihack:core:builder(complex) - Development/Investigation → smart-orchestrator recipe (full orchestration)
Execution flow:
- Classify task (architect agent → JSON decomposition)
- Detect workstreams (1 = single session, 2-5 = parallel via multitask)
- Register session in tree (depth/capacity enforcement)
- Execute rounds (up to 3, goal-seeking reflection loop)
- Summarize results with PR links and GOAL_STATUS
Session tree: Prevents infinite recursion
AMPLIHACK_MAX_DEPTH=3(default) — increase to 5 for deep orchestrationAMPLIHACK_MAX_SESSIONS=10(default) — max concurrent sessions per tree
Status signals:
GOAL_STATUS: ACHIEVED— all criteria metGOAL_STATUS: PARTIAL -- [gaps]— another round will runGOAL_STATUS: NOT_ACHIEVED -- [reason]— final failure status
Related Docs
- reference.md: Architecture (5 mechanisms, 5 layers, hooks)
- examples.md: Scenarios (5+ real examples)
- @~/.amplihack/.claude/context/PHILOSOPHY.md: Core principles
- @~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md: 23 steps
- @~/.amplihack/.claude/agents/amplihack/: All agents
- @~/.amplihack/.claude/commands/amplihack/: All commands
- @~/.amplihack/.claude/tools/amplihack/hooks/: Hook system
- amplifier-bundle/recipes/smart-orchestrator.yaml: Core orchestration recipe
- amplifier-bundle/tools/session_tree.py: Recursion guard (depth limits)
- amplifier-bundle/tools/orch_helper.py: JSON extraction helper
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rysweet/amplihack
chemist-analyst
Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.
rysweet/amplihack
learning-path-builder
Creates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon skill-building, or personal development planning. Not for use in automated development or investigation. Sequences resources (docs, tutorials, exercises) based on current skill level and learning goals. Adapts to learning style: hands-on, theory-first, project-based.
rysweet/amplihack
gh-work-report
Generates comprehensive GitHub activity reports across all authenticated accounts. Gathers repos, PRs, features, and themes for configurable time periods (1/5/7/30/90 days). Produces shareable markdown with tables, mermaid charts, and executive summaries. Can create a private repo with GitHub Actions automation and GitHub Pages aggregation site. Use when: "github report", "work report", "activity summary", "what did I work on", "gh-work-report", "show my github activity".
rysweet/amplihack
pr-review-assistant
Philosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS implementation. Suggests simplifications, identifies over-engineering, verifies brick module structure. Posts detailed, constructive review comments with specific file:line references.
rysweet/amplihack
code-smell-detector
Identifies anti-patterns specific to amplihack philosophy. Use when reviewing code for quality issues or refactoring. Detects: over-abstraction, complex inheritance, large functions (>50 lines), tight coupling, missing __all__ exports. Provides specific fixes and explanations for each smell.
rysweet/amplihack
biologist-analyst
Analyzes living systems and biological phenomena through biological lens using evolution, molecular biology, ecology, and systems biology frameworks. Provides insights on mechanisms, adaptations, interactions, and life processes. Use when: Biological systems, health issues, evolutionary questions, ecological problems, biotechnology. Evaluates: Function, structure, heredity, evolution, interactions, molecular mechanisms.
Didn't find tool you were looking for?