doc-sync
Synchronizes CLAUDE.md navigation indexes and README.md architecture docs across a repository. Use when asked to "sync docs", "update CLAUDE.md files", "ensure documentation is in sync", "audit documentation", or when documentation maintenance is needed after code changes.
reflect
CRITICAL learning capture. Extracts HIGH/MED/LOW confidence patterns from conversations to prevent repeating mistakes and preserve what works. Use PROACTIVELY after user corrections ("no", "wrong"), after praise ("perfect", "exactly"), when discovering edge cases, or when skills are heavily used. Without reflection, valuable learnings are LOST forever. Acts as continuous improvement engine for all skills. Invoke EARLY and OFTEN - every correction is a learning opportunity.
SLO Designer
Design Service Level Objectives (SLOs) with SLIs, targets, alerting thresholds, and error budget calculations following Google SRE best practices. Use when defining reliability targets, designing SLOs, calculating error budgets, or establishing service level indicators.
Decision Critic
Structured decision critic that systematically stress-tests reasoning before commitment, surfacing hidden assumptions, verifying claims, and generating adversarial perspectives to improve decision quality.
security-detection
Detect infrastructure and security-critical file changes to trigger security agent review recommendations ensuring proper security oversight for sensitive modifications.
encode-repo-serena
Systematically populate the Forgetful knowledge base using Serena's LSP-powered symbol analysis for accurate, comprehensive codebase understanding.
analyze
Analyze codebase architecture, security posture, or code quality through guided multi-step investigation. Use when performing architecture reviews, security assessments, quality evaluations, or deep technical investigations. Produces prioritized findings with evidence.
session-qa-eligibility
Checks investigation session QA skip eligibility per ADR-034. Validates if staged files qualify for an investigation-only exemption by checking against allowed paths (.agents/sessions/, .agents/analysis/, .serena/memories/, etc).
fix-markdown-fences
Repair malformed markdown code fence closings. Use when markdown files have closing fences with language identifiers (```text instead of ```) or when generating markdown with code blocks to ensure proper fence closure.
adr-review
Multi-agent debate orchestration for Architecture Decision Records. Automatically triggers on ADR create/edit/delete. Coordinates architect, critic, independent-thinker, security, analyst, and high-level-advisor agents in structured debate rounds until consensus.
Memory Documentary
Generate evidence-based documentary reports by searching across all four memory systems (Claude-Mem, Forgetful, Serena, DeepWiki), project artifacts (.agents/ artifacts), and GitHub issues. Produces investigative journalism-style analysis with full citation chains.
using-serena-symbols
Guidance for using Serena's LSP-powered symbol analysis. Use when exploring codebases, finding symbol definitions, tracing references, or when grep/text search would be imprecise.
Pre-mortem
Guide prospective hindsight analysis to identify project risks before failure occurs. Teams imagine the project has failed spectacularly, then work backward to identify causes. Increases risk identification by 30% compared to traditional planning.
serena-code-architecture
Architectural analysis workflow using Serena symbols and Forgetful memory. Use when analyzing project structure, documenting architecture, creating component entities, or building knowledge graphs from code.
metrics
Collect agent usage metrics from git history and generate health reports. Use when measuring agent adoption, reviewing system health, or producing periodic dashboards. Implements 8 key metrics from agent-metrics.md.
Incoherence Detector
Detect contradictions between documentation and code, ambiguous specs, and policy violations across a codebase. Use when documentation seems stale, specs conflict with implementation, or a pre-release consistency audit is needed. Produces an actionable incoherence report with resolution workflow.
Merge Resolver
Resolve merge conflicts by analyzing Git history and commit intent. Use when a PR has conflicts with the base branch, cannot be merged due to conflicts, or when you need to fix merge conflicts systematically with session-protocol validation.
session
Session management and protocol compliance skill. Use Test-InvestigationEligibility to verify whether staged files qualify for an investigation-only QA skip per ADR-034 before committing with the "SKIPPED: investigation-only" verdict. The skill runs test_investigation_eligibility.py via a set of natural-language triggers, parses its JSON output (Eligible, StagedFiles, Violations), and executes a two-phase process: eligibility check and commit decision. Run this before committing with the "SKIPPED: investigation-only" tag to ensure staged changes meet the allowlist and to avoid improper QA skips. If Eligible=true and Violations is empty, you may proceed with the SKIPPED tag; otherwise, fix the violations or escalate to the qa agent. Integrates with git staging (git add), yields deterministic eligibility results, reduces protocol violations, and clarifies when to use session-init or the qa agent for full sessions or feature work.
Session Log Fixer
Fix session protocol validation failures in GitHub Actions. Use when a PR fails with 'Session protocol validation failed', 'MUST requirement(s) not met', 'NON_COMPLIANT' verdict, or 'Aggregate Results' job failure in the Session Protocol Validation workflow. With deterministic validation, failures show exact missing requirements directly in the Job Summary — no artifact downloads needed.
session-init
Create protocol-compliant JSON session logs with verification-based enforcement. Autonomous operation with auto-incremented session numbers and objective derivation from git state. Use when starting any new session.
planner
Interactive planning and execution for complex tasks. Use when breaking down multi-step projects (planning) or executing approved plans through delegation (execution). Planning creates milestones with specifications; execution delegates to specialized agents.
github-url-intercept
BLOCKING INTERCEPT: When ANY github.com URL appears in user input, STOP and use this skill. Never fetch GitHub HTML pages directly - they are 5-10MB and will exhaust your context window. This skill routes URLs to efficient API calls (1-50KB). Triggers on: pull/, issues/, blob/, tree/, commit/, compare/, discussions/.
using-forgetful-memory
Guidance for using Forgetful semantic memory effectively. Applies Zettelkasten atomic memory principles. Use when deciding whether to query or create memories, structuring memory content, or understanding memory importance scoring.
memory-enhancement
Manage memory citations, verify code references, and track confidence scores. Use when adding citations to memories, checking memory health, or verifying code references are still valid.
SlashCommandCreator
Autonomous meta-skill for creating high-quality custom slash commands using a 5-phase workflow with multi-agent validation and quality gates. Use when a user requests a new slash command, a reusable prompt automation, or wants to convert repetitive workflows into documented commands.
Prompt Engineer
Optimize system prompts for Claude Code agents using proven prompt engineering patterns. Use when users request prompt improvement, optimization, or refinement for agent workflows, tool instructions, or system behaviors.
SkillForge
Intelligent skill router and creator. Analyzes ANY input to recommend existing skills, improve them, or create new ones. Uses deep iterative analysis with 11 thinking models, regression questioning, evolution lens, and multi-agent synthesis panel. Phase 0 triage ensures you never duplicate existing functionality.
GitHub
Execute GitHub operations (PRs, issues, milestones, labels, comments, merges) using Python scripts with structured output and error handling. Use when working with pull requests, issues, review comments, CI checks, or milestones instead of raw gh.
Programming Advisor
Evaluate existing solutions (libraries, SaaS, open source) before custom development to avoid reinventing the wheel. Use when considering building new features, asking 'should I build or use existing', or need build vs buy cost analysis with token estimates.
exploring-knowledge-graph
Guidance for deep knowledge graph traversal across memories, entities, and relationships. Use when needing comprehensive context before planning, investigating connections between concepts, or answering "what do you know about X" questions.
PR Comment Responder
A PR review coordinator that gathers comment context, acknowledges every piece of feedback, and ensures all reviewer comments are addressed systematically. It triages comments by actionability, tracks threaded conversations, and maps each comment to a resolution status. Use this when handling pull request feedback, review threads, or bot comments.
session-migration
Migrate session logs from markdown to JSON format. Use when PRs contain markdown session logs that need conversion to the new JSON schema, or when batch-migrating historical sessions.
memory
Unified four-tier memory system for AI agents. Tier 1 Semantic (Serena+Forgetful search), Tier 2 Episodic (session replay), Tier 3 Causal (decision patterns). Enables memory-first architecture per ADR-007.
steering-matcher
Match file paths against steering file glob patterns to determine applicable steering guidance. Use when orchestrator needs to inject context-aware guidance based on files being modified.
Cynefin Classifier
Classify problems into the Cynefin Framework domains (Clear, Complicated, Complex, Chaotic, Confusion) and recommend appropriate response strategies. Use when unsure how to approach a problem, facing analysis paralysis, or needing to choose between expert analysis and experimentation.
Chaos Experiment
Design and document chaos engineering experiments. Guide steady-state baselines, hypothesis formation, failure-injection plans, and results analysis. Use for resilience testing, game days, failure-injection experiments, and building confidence in system stability.
research-and-incorporate
Research external topics, create comprehensive analysis, determine project applicability, and incorporate learnings into Serena and Forgetful memory systems. Transforms knowledge into searchable, actionable project context.
git-advanced-workflows
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.
codeql-scan
Execute CodeQL security scans with language detection, database caching, and SARIF output. Use when performing static security analysis on Python or GitHub Actions code.
Threat Modeling
Structured security analysis using the OWASP Four-Question Framework and STRIDE methodology. Generates threat matrices with risk ratings, mitigations, and prioritization. Use for attack surface analysis, security architecture review, or when asking what can go wrong.
curating-memories
Guidance for maintaining memory quality through curation. Covers updating outdated memories, marking obsolete content, and linking related knowledge. Use when memories need modification, when new information supersedes old, or when building knowledge graph connections.