CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-doc-discipline

Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and carrying a why, steps before reference, one meaning in one home, no restating what the environment already says. Mandatory at drydock seed generation and the launch C5 sediment pass; opt-in for any other agent-facing doc edit. The companion of minimal-code-discipline: that one disciplines code, this one disciplines papers.

Quality

82%

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

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

A lean, well-structured discipline document whose rules are genuinely checkable thanks to inline tests and a closing verification checklist. The main gaps are the modest duplication between the Discipline and Verification sections and the absence of worked before/after examples of a well-formed rule.

DimensionReasoningScore

Conciseness

The body is dense and lean — every rule earns its place, assumes Claude's competence, and never explains concepts Claude already knows; the one trimmable instance is the Verification section restating rules already fully stated in The Discipline (e.g., 'every rule is checkable and states its why; no rule restates a lookup'), fitting anchor 4's 'minor instances that could be trimmed' rather than anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

As an instruction-only skill it gives concrete, executable guidance: every rule pairs an observable condition with a runnable test (e.g., 'changing a behavior is a one-place edit', 'the last line answers "what do I do next?" without scrolling up') and a negative example ("No 'keep it clean' — write the observable condition and the reason"), but it lacks worked examples of a well-formed rule, so it stops short of anchor 5's 'specific examples cover the common cases'.

4 / 5

Workflow Clarity

The single action (apply the discipline while writing) is unambiguous and the Verification section supplies explicit validation checkpoints before reporting done ('a fresh session could act on it without asking a human anything'), but the thirteen rules are presented as an unordered set of principles rather than a sequenced process, fitting anchor 4's 'clear sequence with most checkpoints present' rather than anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

At roughly 50 lines with no bundle files and no external references, the body is cleanly organized into three well-labeled sections (When Not to Use, The Discipline, Verification), nothing that belongs in a separate file is inlined, and there are no nested references — matching the simple-skill exception for a 5.

5 / 5

Total

17

/

20

Passed

Description

78%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, third-person description that answers both what and when with concrete, domain-specific triggers and explicit disambiguation from its companion skill. Its main weakness is reliance on project-internal jargon (drydock, C5 sediment pass) that limits natural trigger matching for anyone outside the project.

DimensionReasoningScore

Specificity

The description names its domain concretely ("documents agents consume (the five surfaces, specs, tickets, .omc/skills/)") and enumerates several distinct rule behaviors ("every rule checkable and carrying a why, steps before reference, one meaning in one home, no restating what the environment already says"), but these are abstract discipline properties rather than the operational actions of anchor 5, placing it noticeably above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both what ("Writing-time discipline for documents agents consume…") and when ("Mandatory at drydock seed generation and the launch C5 sediment pass; opt-in for any other agent-facing doc edit") are explicitly stated, so it clears anchor 3; but the when hinges on internal jargon rather than anchor 5's concrete natural trigger phrases, fitting anchor 4's 'when could be more explicit or specific'.

4 / 5

Trigger Term Quality

Good natural keywords are present ("specs", "tickets", "skill files", "agent-facing doc edit"), but common variations users would say are missing ("documentation", "CLAUDE.md", "README") and the mandatory triggers lean on project-internal jargon ("drydock seed generation", "launch C5 sediment pass") no outside user would naturally say — matching anchor 4, not anchor 5's comprehensive synonym coverage nor anchor 3's missing-common-terms profile.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (writing discipline for agent-consumed documents) and explicitly disambiguates from its nearest neighbor ("The companion of minimal-code-discipline: that one disciplines code, this one disciplines papers"), leaving minimal conflict risk — anchor 5, not anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

Yeachan-Heo/oh-my-claudecode

Path

skills/agent-doc-discipline/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.