Description

This PR adds the second-mind skill to the awesome-claude-skills repository.

second-mind builds and maintains a living, Obsidian-compatible technical code wiki (./mind/) directly inside the codebase. It automatically scans codebases, captures decisions, and generates high-fidelity wiki guides (Database, Auth, APIs, Deployment, and Workflows) while leveraging search tools to verify API contracts, dependencies, and user requirements.

Real-World Use Case

• What problem the skill solves: While standard configurations like a CLAUDE.md file are excellent for static project instructions, coding styles, and build/test commands, they do not act as a living, dynamic repository-level context or a comprehensive technical wiki (detailing database configurations, auth middleware flows, API parameter schemas, or session-by-session task progression). Maintaining detailed technical wikis manually is time-consuming and leads to staleness. second-mind solves this by complementing the static CLAUDE.md file. It automatically scans, generates, and maintains a structured technical code wiki (./mind/guides/, ./mind/decisions/, and ./mind/sessions/) at the end of every chat session and restores active context at the beginning of the next.

• Who uses this workflow: Software engineers, tech leads, and onboarding developers who want an automated, structured technical wiki that stays in sync with code evolution.

• Attribution/Inspiration: Inspired by "Docs-as-code" guidelines, Obsidian's Map of Content (MOC) design systems, and documentation best practices from the Berkeley Library Guide and IBM Code Documentation.

Example Usage

User: /second-mind wiki

Output:

 Second Mind — Technical Wiki Generation

 Scanning codebase...
  - Detected database connections in `src/config/db.ts`
  - Detected 12 database models under `src/models/`
  - Detected JWT session verification in `src/middleware/auth.ts`
  - Detected 18 API routes under `src/routes/`

 Searching Google for best practices & verification...
  - Researched: "PostgreSQL row level security policies multi-tenant"
  - Researched: "JWT session cookie Security options Node.js"

 Generating Code Wiki guides:
  ✅ Generated: mind/guides/database.md (Postgres schema, 12 tables mapped)
  ✅ Generated: mind/guides/auth-security.md (JWT auth workflow, RBAC matrix, route protection)
  ✅ Generated: mind/guides/api-integrations.md (18 API routes mapped with inputs, outputs, exceptions)
  ✅ Generated: mind/guides/deployment.md (Vercel serverless deployment config)
  ✅ Generated: mind/guides/workflows.md (Setup instructions, new endpoint recipes)
  ✅ Generated: mind/guides/standards.md (Docstring and naming standards)

👉 Code Wiki successfully updated at mind/guides/!

Skill Requirements Checklist

• Solves a real problem: Addresses codebase context drift and stale documentation.
• Well-documented: Complete instructions, structure, and templates are detailed in SKILL.md.
• Accessible: Commands are simple (/second-mind init, /second-mind wiki, etc.).
• Includes examples: Real-world output examples for restore and wiki commands.
• Tested: Verified across Claude Code and Antigravity environments.
• Safe: Requires explicit confirmation for initialization; does not execute destructive actions.
• Portable: Works across Claude Code, Antigravity, and other tool-enabled environments.