{
  "markdown": "# Coding Wisdom for Claude Code\n\n> Systematically capture and organize coding wisdom accumulated during development tasks.\n\nA Claude Code skill that helps you build a personal knowledge base of coding insights. Capture development principles, debug approaches, user-caring details, and non-consensus tips that emerge during real coding work.\n\n## Features\n\n- **📝 Capture Mode** - Record wisdom after coding sessions with rich interactive prompts\n- **🔍 Search Mode** - Find relevant wisdom before starting new tasks\n- **📚 Browse Mode** - Explore accumulated wisdom by category\n- **🏷️ Tag System** - Organize wisdom with searchable tags\n\n## Categories\n\n| Category | Description | Example |\n|----------|-------------|---------|\n| **Development Principles** | High-level approaches to building software | \"Read existing code before writing new code\" |\n| **Debug Principles** | Systematic approaches to troubleshooting | \"Change one thing at a time when debugging\" |\n| **Trivial User Features** | Small details users care about | \"Button hover states provide user confidence\" |\n| **Non-Consensus Tips** | Counter-intuitive but effective practices | \"Write tests after implementation works\" |\n\n## Installation\n\n### Option 1: Install from GitHub (recommended)\n\n1. Clone this repository to your local skills directory:\n```bash\ncd ~/.claude/skills\ngit clone https://github.com/your-username/coding-wisdom.git\n```\n\n2. Restart Claude Code\n\n3. The skill will be automatically available\n\n### Option 2: Manual Installation\n\n1. Copy the `coding-wisdom/` folder to `~/.claude/skills/`\n2. Restart Claude Code\n\n## Usage\n\n### Capture Wisdom\n\nAfter completing a coding task, capture what you learned:\n\n1. Invoke the skill: \"Use coding-wisdom to capture something I learned\"\n2. Select the category (Development, Debug, Trivial, Non-Consensus)\n3. Answer the prompts:\n   - Title (short, memorable)\n   - Context (what led to this discovery)\n   - The Principle (clear explanation)\n   - Why It Works (rationale)\n   - Tags (for categorization)\n\n### Search Wisdom\n\nBefore starting a new task, find relevant insights:\n\n```bash\n# View summary of all wisdom\npython3 ~/.claude/skills/coding-wisdom/scripts/search_wisdom.py --summary\n\n# Search by category\npython3 ~/.claude/skills/coding-wisdom/scripts/search_wisdom.py --category debug\n\n# Search by tags\npython3 ~/.claude/skills/coding-wisdom/scripts/search_wisdom.py --tags testing,debugging\n\n# Full-text search\npython3 ~/.claude/skills/coding-wisdom/scripts/search_wisdom.py --search \"test\"\n```\n\n### Command-Line Interface\n\n```bash\n# Interactive capture\npython3 scripts/capture_wisdom.py --interactive\n\n# Get help\npython3 scripts/search_wisdom.py --help\n```\n\n## File Structure\n\n```\ncoding-wisdom/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin metadata\n├── SKILL.md                 # Main skill instructions\n├── scripts/\n│   ├── init_wisdom.py       # Initialize wisdom storage\n│   ├── capture_wisdom.py    # Interactive capture script\n│   └── search_wisdom.py     # Search by category/tags\n├── references/\n│   ├── categories.md        # Detailed category definitions\n│   └── wisdom-template.md   # Template for manual creation\n├── wisdom/\n│   ├── development/         # Development principles\n│   ├── debug/               # Debug principles\n│   ├── trivial/             # Trivial user features\n│   └── nonconsensus/        # Non-consensus tips\n├── LICENSE\n└── README.md\n```\n\n## Wisdom Storage Format\n\nEach wisdom item is stored as a markdown file:\n\n```markdown\n---\ncategory: nonconsensus\ntags: [testing, pragmatic]\ncontext: rails-api-project\ndate: 2026-03-05\n---\n\n# Write Tests After Implementation Works\n\n**Context:** Discovered during Rails API development after repeatedly rewriting tests.\n\n**The Principle:**\nWrite tests after the implementation is working correctly, not before.\n\n**When to Apply:**\n- Exploratory development where the API surface is evolving\n- Integration with external services where contracts are uncertain\n\n**When NOT to Apply:**\n- Well-defined business rules with clear acceptance criteria\n\n**Why It Works:**\n- Tests document what the code actually does\n- Avoids test rewrites during implementation discovery\n- Catches edge cases you didn't anticipate\n```\n\n## Contributing\n\nContributions are welcome! Feel free to:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Acknowledgments\n\nInspired by the Claude Code plugin ecosystem and the following skills:\n- **file-todos** - File-based tracking system patterns\n- **setup** - Rich CLI interaction patterns\n- **dhh-rails-style** - Knowledge organization patterns\n- **brainstorming** - Phase-based workflow patterns\n\n## Support\n\nFor issues, questions, or suggestions:\n- Open an issue on GitHub\n- Mention `@coding-wisdom` in Claude Code conversations\n\n---\n\n**Made with ❤️ for the Claude Code community**\n",
  "bytes": 4922,
  "sha": "e608165ecd8f3ac1736bc159dda7dbeb912a3a62cfb0ef50bea03fed84236b31",
  "repo_slug": "erinyu/coding-wisdom",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_erinyu_coding_wisdom_coding_wisdom_386afc76/readme"
}