When does the Arc Document skill trigger?

The skill triggers automatically when it detects phrases like 'that worked', 'it's fixed', or 'problem solved' in your conversation, but it can also be manually invoked using the /arc:document command.

Where are the documented solutions stored?

All solutions are saved as Markdown files within your repository's 'docs/solutions/' folder, organized by category for easy searching and future reference.

Does it document every minor code change?

No, it is specifically designed for non-trivial problems—those requiring multiple investigation attempts or non-obvious solutions—to ensure your documentation remains high-quality and relevant.

How does this benefit future Claude Code sessions?

Claude references the solutions directory and progress journal at the start of new sessions, allowing the AI to surface past learnings and avoid repeating previous mistakes.

Arc Document

Name: Arc Document
Author: howells

byhowells

•

Gestión de Contenido

Captures solved technical problems as searchable documentation to build institutional knowledge for future development sessions.

The Arc Document skill for Claude Code automates the preservation of hard-won technical insights by transforming successful troubleshooting sessions into structured repository documentation. By monitoring for success triggers like 'it's fixed' or 'that worked,' the skill prompts the user to record symptoms, root causes, and failed attempts into a searchable solutions directory. This creates a persistent 'knowledge loop' that Claude can reference in future sessions, ensuring that non-obvious fixes and complex debugging paths are never lost and can inform future architectural decisions.

Características Principales

01Automated progress journal updates to track institutional knowledge growth

02Searchable documentation storage within the local docs/solutions directory

03Structured classification of issues into categories like build errors, UI bugs, and config issues

046 GitHub stars

05Automatic invocation based on natural conversation triggers like 'problem solved'

06Comprehensive solution templates capturing symptoms, root causes, and prevention steps

Casos de Uso

01Documenting a complex state management fix that required multiple debugging iterations

02Recording the specific configuration steps needed to resolve a flaky CI/CD pipeline error

03Capturing a non-obvious workaround for a third-party API integration bug for team reference

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add howells/arc document

For use in Claude.ai and ChatGPT

Download Skill