cc-config-author

Audit and author Claude Code configuration files against the 2026 April specification.

10|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill cc-config-author-cynthia1070711
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cc-config-author
Source: https://github.com/Cynthia1070711/PHYCOOL_Tools/tree/main/config-templates/claude/skills/cc-config-author
Command: npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill cc-config-author-cynthia1070711

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Claude Code configuration files (CLAUDE.md, rules, skills, commands, agents, settings.json) drift out of spec as Anthropic ships new frontmatter fields and deprecates old ones, causing silent failures like rules that never load or token budgets that blow up. This Skill acts as a spec gatekeeper so every config change follows the 2026 April rules and avoids known bugs. ## Core Features & Use Cases - 7-step audit playbook: Identify file type, read the matching spec reference, apply token budgets, validate frontmatter, check known bugs (#23478, #21858, #16299, #16853), write, and verify. - Automated compliance scanning: Run scripts/audit-config.js to check CLAUDE.md line counts, rules paths frontmatter, SKILL.md naming, settings.json deprecated env vars, and hook file integrity. - PostToolUse guard hook: cc-config-guard.js injects spec reminders whenever any .claude/ file is written, working around Bug #23478 where paths rules do not load on Write. - Use Case: You want to add a new rule that only applies to TypeScript API files. The Skill tells you to use paths frontmatter, warns that Write-triggered creation will not load it (Bug #23478), and provides a hook fallback plus a copy-ready template. ## Quick Start Ask the AI to audit your .claude directory for 2026 spec compliance using the cc-config-author skill.

Frequently Asked Questions about cc-config-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Claude Code configuration files for spec compliance?

Run node .claude/skills/cc-config-author/scripts/audit-config.js from your project root. It scans CLAUDE.md, rules, skills, commands, agents, hooks, and settings.json, then outputs errors, warnings, and token budget violations against the 2026 April spec.

Why is my Claude Code rule with paths frontmatter not triggering?

Two known bugs cause this: Bug #23478 means paths rules do not load when the Write tool creates a file, only on Read, and Bug #21858 means paths in user-level ~/.claude/rules never load. Move rules to project level and add a PostToolUse hook as a fallback.

What is the line limit for CLAUDE.md in Claude Code?

The soft limit is 120 lines and the hard limit is 200 lines for a project-root CLAUDE.md. Beyond 200 lines, instruction adherence measurably drops, so detailed content should move to .claude/rules with paths frontmatter or to skills.

Does a Claude Code subagent inherit skills from the parent session?

No, subagents do not inherit parent skills. You must explicitly list every needed skill in the subagent frontmatter skills field, otherwise the isolated context starts without them.

What frontmatter fields are required in a SKILL.md file?

Only name and description are required. The name must be lowercase with hyphens, at most 64 characters, match the directory name, and avoid reserved words like claude. The description should be third-person with explicit trigger phrases.

Do settings.json hook changes apply immediately in Claude Code?

No, changes to the hooks block in settings.json do not hot-apply by design. You must run /clear or restart the CLI for new or modified hooks to take effect.