Skip to content

chore(dx): slim CLAUDE.md and restructure skills (#73)#74

Merged
x3ek merged 5 commits intomainfrom
chore/73-slim-claude-md
Mar 21, 2026
Merged

chore(dx): slim CLAUDE.md and restructure skills (#73)#74
x3ek merged 5 commits intomainfrom
chore/73-slim-claude-md

Conversation

@x3ek
Copy link
Contributor

@x3ek x3ek commented Mar 21, 2026

Summary

  • Reduce CLAUDE.md from 462 to 81 lines — only universal instructions remain
  • Create dev-setup skill (local setup, scripts, config, deployment)
  • Create git skill (conventional commits, branch naming, commit messages)
  • Split github and theme-creator skills into lean SKILL.md + reference files following progressive disclosure pattern
  • Move agent-facing scripts (github-issue-updater.py, setup-worktree.py) from scripts/ into their respective skill directories
  • Add check-env.py readiness check script for agents
  • Add playwright artifacts to .gitignore
  • scripts/ now only contains user-facing scripts (start-dev.py, run-checks.py)

Closes #73

Test plan

  • python scripts/run-checks.py — 4/4 checks pass
  • Moved scripts executable from new locations
  • check-env.py correctly validates dev environment
  • scripts/ only contains user-facing scripts
  • CLAUDE.md under 200 lines (81 lines)

🤖 Generated with Claude Code

x3ek and others added 5 commits March 21, 2026 09:41
Reduce CLAUDE.md from 462 to 81 lines by moving domain-specific content into skills. Create dev-setup skill (local setup, scripts, config, deployment) and git skill (conventional commits, branch naming). Move git conventions out of github skill. Add content repo structure and frontmatter to theme-creator skill. Drop discoverable content (architecture, tech stack, repo structure, design decisions).

Part of #73

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Split github and theme-creator skills into lean SKILL.md + reference files following the progressive disclosure pattern from playwright-cli. Move agent-facing scripts (github-issue-updater.py, setup-worktree.py) from scripts/ into their respective skill directories. Add dev environment readiness check script.

Part of #73

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Script moved from scripts/ to .claude/skills/git/scripts/ but PROJECT_ROOT still used parent.parent (2 levels). Now uses parents[4] to reach repo root from new location.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@x3ek x3ek merged commit 3dfa358 into main Mar 21, 2026
5 checks passed
@x3ek x3ek deleted the chore/73-slim-claude-md branch March 21, 2026 15:22
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.

Slim down CLAUDE.md and move domain content into skills

1 participant