Skip to content

feat: add generate-claudemd skill for bootstrapping project CLAUDE.md files#104

Merged
notque merged 1 commit intomainfrom
feat/claudemd-generator
Mar 23, 2026
Merged

feat: add generate-claudemd skill for bootstrapping project CLAUDE.md files#104
notque merged 1 commit intomainfrom
feat/claudemd-generator

Conversation

@notque
Copy link
Owner

@notque notque commented Mar 23, 2026

Summary

  • New generate-claudemd skill — 4-phase pipeline (SCAN → DETECT → GENERATE → VALIDATE) that analyzes a repo and produces a project-specific CLAUDE.md
  • Auto-detects language/framework and enriches output with domain-specific conventions (e.g., go-sapcc-conventions for sapcc Go repos)
  • Includes a reference template (CLAUDEMD_TEMPLATE.md) defining required and optional sections
  • Complements the official claude-md-improver plugin: this generates new files, that improves existing ones

Components

File Purpose
skills/generate-claudemd/SKILL.md Skill definition (534 lines, Medium complexity)
skills/generate-claudemd/references/CLAUDEMD_TEMPLATE.md Template for generated CLAUDE.md files
commands/generate-claudemd.md Slash command registration

Domain enrichment routing

  • go.mod + sapcc imports → load go-sapcc-conventions patterns
  • Any Go repo → add Go error handling and testing sections
  • package.json → add Node.js/TypeScript sections
  • pyproject.toml → add Python sections

Inspired by

Analysis of sapcc/archer PR #707 which demonstrated what a good project-level CLAUDE.md looks like for an sapcc Go service.

Test plan

  • Skill created via skill-creator-engineer (creation gate satisfied)
  • Template reference file created with required/optional section structure
  • Slash command registered
  • Synced to ~/.claude/skills/ and ~/.claude/commands/

… files

4-phase pipeline (SCAN → DETECT → GENERATE → VALIDATE) that analyzes a
repo's code, build system, and architecture to produce a project-specific
CLAUDE.md. Auto-detects language/framework and enriches output with
domain-specific conventions — e.g., invokes go-sapcc-conventions for
sapcc Go repos.

Includes:
- skills/generate-claudemd/SKILL.md (534 lines, Medium complexity)
- skills/generate-claudemd/references/CLAUDEMD_TEMPLATE.md (template)
- commands/generate-claudemd.md (slash command registration)

Complements the official claude-md-improver plugin: this skill generates
new CLAUDE.md files from scratch, while the plugin improves existing ones.
@notque notque merged commit df77b5d into main Mar 23, 2026
3 checks passed
@notque notque deleted the feat/claudemd-generator branch March 23, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant