CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-md-progressive-disclosurer

Optimizes or restructures CLAUDE.md/AGENTS.md with progressive disclosure and zero information loss. Use when the user asks to optimize, audit, 精简/瘦身/重构, or split instruction files, asks for their best practices (最佳实践), sees Memory files taking a large share of /context, reports rules in instruction files being ignored, or a task starts moving instruction sections. Not for generic task drift unless instruction files are in scope; not for moving memory entries into docs (use claude-code-ops-router).

67

Quality

84%

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

73%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.

An extremely thorough, highly actionable workflow with exemplary validation and recovery loops, undermined by systematic internal repetition — the grep-trap and anti-KPI rules are each restated many times, and war-story parentheticals pad nearly every section, ironically violating the skill's own single-source-of-truth principles. The reference bundle is genuine and well-signaled, but the main file carries far more than an overview should.

Suggestions

Consolidate the grep-vs-python-substring verification trap (currently fully explained in Step 4, 反模式 6, 反模式 9, and 5.0) into one canonical statement plus short pointers, and move the war-story anecdotes (案例 15/16/19 parentheticals) into progressive_disclosure_principles.md where the case studies already live.

Reduce the 'line count is not a KPI' rule, which is restated in the 铁律, 触发即 reframe, 反模式 1, 反模式 5, 5c, and the checklist, to one canonical section plus brief cross-references, freeing substantial tokens without losing the rule.

Move the detailed payload/shell-trap and probe material inline in the body (e.g., the codex jq command block and symlink rules) into verification-recipes.md with a trigger-condition pointer, keeping SKILL.md closer to the decision-and-entry-point overview the skill itself prescribes.

DimensionReasoningScore

Conciseness

The ~550-line body repeats the same guidance many times: the grep-vs-python-substring verification trap is fully explained at least four times (Step 4 硬 gate, 反模式 6, 反模式 9, 5.0 guidance), the 'line count is not a KPI' rule is restated in 铁律, 触发即 reframe, 反模式 1, 反模式 5, 5c, and the final checklist, and parenthetical war-story anecdotes (「实战:...案例 15/16/19」) pad many sections. This matches the anchor for noticeably verbose with several padded/unnecessarily repeated sections; it is above the 'extensively explains concepts Claude already knows' level because the material is domain-specific and mostly non-obvious, and below the 'mostly efficient with only minor trimming needed' level because the duplication is systematic rather than incidental.

2 / 5

Actionability

The body gives fully executable, copy-paste-ready guidance throughout: exact commands (`codex debug prompt-input 'startup-instruction-audit' | jq ...`), concrete code (`Path("orig").read_bytes() in Path("target").read_bytes()`), script invocations with operational warnings (`scripts/sink_sections.py`, `profile_claude_md.py`, including that it has no dry-run), copyable citation formats, and naming conventions (`docs/references/{主题}-sop.md`). This matches the top anchor of fully executable, copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

A clearly sequenced 5-step workflow (baseline → measurement/triage/layering → reference creation → L1 update → verification 5a/5b/5c) with explicit validation checkpoints (pre-write pointer gate, byte-level integrity checks, calibrated-criteria requirement), error-recovery feedback loops (verification failure restores the source file; re-run prohibited after mid-I/O failure to avoid duplicate appends), and a final checklist. This matches the anchor for a clear sequence with explicit validation, recovery loops, and a checklist; the batch/destructive-operation validation cap does not apply because validation is pervasive.

5 / 5

Progressive Disclosure

The bundle is real and well-wired: both references exist and contain the cited appendices A-D and case studies, all three scripts are referenced from the body, and pointers are one level deep with explicit trigger conditions (「何时读」/触发场景) — matching the good-structure anchor with mostly appropriate placement and clear references. It falls short of the top anchor because the SKILL.md itself is a dense 550-line methodology rather than a lean overview; significant case-driven and verification-detail material arguably belongs in the already-existing reference files, especially given the skill's own anti-duplication doctrine.

4 / 5

Total

16

/

20

Passed

Description

90%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 well-crafted, third-person description with an explicit Use-when clause, rich bilingual trigger terms, and clear negative-scope boundaries that deconflict it from neighboring skills. The only weakness is capability coverage: it states the core optimize/restructure action but leaves profiling, backup, and verification work unmentioned, making the 'what' slightly thinner than the 'when'.

DimensionReasoningScore

Specificity

The description names the domain clearly ("Optimizes or restructures CLAUDE.md/AGENTS.md with progressive disclosure and zero information loss") plus a few more action verbs in the trigger clause ("optimize, audit, 精简/瘦身/重构, or split instruction files"), but coverage of what the skill actually does is not comprehensive — profiling/measurement, backup, verification, and script tooling are never mentioned. This matches the anchor for naming the domain with 1-2 concrete actions; it is below the level listing several specific actions with minor gaps and above the generic-actions-only level.

3 / 5

Completeness

It explicitly answers both what ("Optimizes or restructures CLAUDE.md/AGENTS.md with progressive disclosure and zero information loss") and when ("Use when the user asks to..." with multiple concrete trigger phrases, plus explicit negative scope "Not for generic task drift... not for moving memory entries into docs"). This is the anchor that clearly and explicitly answers both what AND when with concrete triggers; not the level below because the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Comprehensive natural trigger coverage including synonyms in two languages: "optimize, audit, 精简/瘦身/重构, or split instruction files", "best practices (最佳实践)", "Memory files taking a large share of /context", and "rules in instruction files being ignored" — each is a phrase a real user would plausibly say. This matches the top anchor covering natural terms including synonyms; no common variation is obviously missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (instruction-file progressive-disclosure restructuring) with distinct triggers and explicit disambiguation against adjacent skills ("not for moving memory entries into docs (use claude-code-ops-router)", "Not for generic task drift unless instruction files are in scope"), which actively reduces conflict risk. This matches the top anchor for a clear niche with minimal conflict; the deconfliction pointers are stronger than the 'mostly distinct' level below.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (564 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

daymade/claude-code-skills

Path

daymade-claude-code/claude-md-progressive-disclosurer/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.