Claude-skill-registry coding-guidelines-gen
Generate nested AGENTS.md coding guidelines per module (monorepo-aware), detect languages/tooling, ask architecture preferences, and set up missing formatters/linters (Spotless for JVM). Use when the user wants module-scoped AGENTS.md coding guidelines or to set up missing formatters/linters.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/coding-guidelines-gen" ~/.claude/skills/majiayu000-claude-skill-registry-coding-guidelines-gen && rm -rf "$T"
manifest:
skills/data/coding-guidelines-gen/SKILL.mdsource content
Coding guidelines generator
Goal
Create nested
AGENTS.md files (not repo root) that define:
- architecture preferences + boundaries (high level)
- formatting/lint/testing commands (runnable)
- a small verifiable config block the verifier skill can execute
Minimal questions to ask (don’t skip)
- Where are the module roots? (Confirm the folders that should each get an
; avoid repo root unless explicitly requested.)AGENTS.md - Architecture style: layered / hex / clean (pick one) and any hard boundaries (e.g.,
must not importdomain/
).infra/ - OK to add tooling when missing? (default: yes; Spotless for Java/Kotlin)
- Default commands: format / lint / test for each module (changed-files-first where practical).
Workflow (monorepo-aware)
- Scan for candidate modules and languages.
- Use
to produce a quick inventory.scripts/scan_modules.py - If
is not available or the script fails, tell the user and ask whether to install Python or proceed with a manual module scan.python
- Use
- Propose the nested
placement(s) and get confirmation.AGENTS.md- If the only detected module is repo root, suggest a subdir (e.g.,
,src/
,apps/<name>/
) or ask the user where the code “starts”.packages/<name>/
- If the only detected module is repo root, suggest a subdir (e.g.,
- For each confirmed module root:
- Create/update
using<module>/AGENTS.md
.references/agents-template.md - Fill the
JSON block (schema:codex-guidelines
) with runnable commands.references/verifiable-block.md
- Create/update
- Ensure formatting + linting exist (prefer existing; otherwise add best-practice defaults).
- JVM (Gradle/Maven): add/configure Spotless (see
).references/spotless.md - Others: pick a minimal, common default and wire commands into
(seeAGENTS.md
).references/language-defaults.md
- JVM (Gradle/Maven): add/configure Spotless (see
Deliverable
Provide:
- The list of module roots covered and each
created/updated.AGENTS.md - The
command block per module (format/lint/test).codex-guidelines - Any tooling/config changes added (e.g., Spotless) and where they live.