CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding-guidelines-generator

Use when asked to generate or set up coding guidelines, detect my stack, generate AGENTS.md rules, create stack-specific conventions, set up agent guidelines, or configure coding guidelines for this repo on first use in a codebase. Deterministically detects tech stack layers, confirms with the user, generates tailored guidelines from modular references, and links them from AGENTS.md without overwriting user content. Excludes general code review, linter/formatter configuration, or CI pipeline setup.

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary deterministic router: dense routing table, precise commands, and an explicit guardrailed workflow. The only gaps are undefined placeholder details (pm substitution, hash generation) and the absence of an explicit post-write verification step.

Suggestions

Define the 'pm' substitution placeholder in the body or note that its value is emitted by detect_stack.py output, so the upsert_section.py invocation is fully self-contained.

Add an explicit post-write verification step to the workflow (e.g., re-read the upserted file to confirm content outside the markers is byte-identical before reporting success).

Briefly state how the marker hash is derived (or that upsert_section.py computes it), so 'Report: ... hash status' in step 7 is verifiable.

DimensionReasoningScore

Conciseness

The body is a lean routing table plus a 7-step workflow with zero padding and no explanation of concepts Claude already knows; every line (stack names, signature files, target outputs, commands) carries instruction. Matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Concrete executable commands are given ("python3 scripts/detect_stack.py --root .", "scripts/upsert_section.py --file <path> --content-file <ref> --hash --substitute pm=<pm>", exact marker format), plus a manual fallback. Not 5: the source of the "pm" substitution value and how the marker hash is produced are not defined in the body; not 3: the commands are real and executable, not pseudocode, with only minor gaps.

4 / 5

Workflow Clarity

A clearly sequenced 7-step workflow with real checkpoints: "Never write before confirmation", confirmation step with dry-run/remove modes, "Never alter text outside the markers", and a determinism claim ("Re-running on unchanged code is byte-identical"). Not 5: no explicit post-write verification step (e.g., re-reading the upserted file to confirm content outside markers is intact) or error-recovery loop; not 3: checkpoints are explicit, not implicit.

4 / 5

Progressive Disclosure

SKILL.md is a pure router: a routing table maps each detected stack to its exact reference file and load condition, and all 14 references/ files plus 2 scripts and 2 assets exist and are one level deep (reference files do not point to further reference files). Per-stack detail, baseline text, and the AGENTS.md section template are all correctly split out of the overview.

5 / 5

Total

18

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when' trigger clause, concrete third-person capability statements, and explicit exclusions that sharply delimit its scope. The only blemishes are the first-person "my stack" phrasing and a few missing trigger synonyms like 'coding standards'.

DimensionReasoningScore

Specificity

"Deterministically detects tech stack layers, confirms with the user, generates tailored guidelines from modular references, and links them from AGENTS.md without overwriting user content" lists multiple specific concrete actions with comprehensive coverage (anchor 5), but the first-person phrasing "detect my stack" violates the third-person-voice rule, reducing the score by 1. Not 3: far more than 1-2 concrete actions; the capability sentence itself is purely third person.

4 / 5

Completeness

Explicitly answers 'what' ("detects tech stack layers, confirms with the user, generates tailored guidelines... and links them from AGENTS.md") and 'when' with a concrete "Use when asked to... on first use in a codebase" trigger clause, plus explicit exclusions. Clearly matches the anchor for both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would say are well covered: "generate or set up coding guidelines", "generate AGENTS.md rules", "create stack-specific conventions", "set up agent guidelines". Not 5: common variations like "coding standards" or "code style" are missing; not 3: multiple natural synonyms and phrasings are present rather than only some relevant keywords.

4 / 5

Distinctiveness Conflict Risk

A clear niche (stack detection → guideline generation → AGENTS.md linking) with distinct triggers, and explicit boundary guidance: "Excludes general code review, linter/formatter configuration, or CI pipeline setup" minimizes conflict with related skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

administrakt0r/pro-skills-repo-administraktor

Path

skills/development-skills/coding-guidelines-generator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.