CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

authored-decision-order

Check that deciding the authored review tree's pending changes one at a time, in any order, gives the document that deciding them all at once gives, and that no change adds a set of verdicts a reviewer can only decide together, for every document up to a bound. Use before and after changing packages/plitejs/src/authored/tree/resolve.ts or another file in its coverage record, when the authored-order step of pnpm check fails, when fixing a decision-order bug, or when recording gains a new kind of mark.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/authored-decision-order/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 skill is fully actionable — exact commands, flags, expected counts, failure formats, and a disciplined validation loop with a shrink-only baseline — and its workflow is genuinely sequenced. Its main problems are token efficiency and structure: enormous padded paragraphs of historical findings and coverage detail belong in reference files rather than the main SKILL.md, which currently has no progressive disclosure at all.

Suggestions

Move the Findings history, the 'What a pass proves' planted-bug catalogue, and the Coverage record tables into reference files (e.g. references/findings.md, references/coverage.md) and keep a short summary plus pointers in SKILL.md — the body currently inlines ~100 lines of historical record that is only needed when triaging a specific failure.

Tighten the long run-on paragraphs in 'What it checks' and the family sections into compact bullet lists of the bound dimensions and rules; details like per-commit timings and load averages ('in about 26 s with the load average near 15') can be dropped or reduced to one representative figure.

Lead the body with a short 'How to run' section stating the gate command and the four modes in a few lines, so a reader can act before absorbing the property explanation, the family descriptions, and the findings history.

DimensionReasoningScore

Conciseness

The body runs ~186 lines / ~47KB of dense run-on prose; the Findings, 'What a pass proves', and Coverage record sections carry exhaustive historical detail — commit hashes (da4bc3e523, 03d633b0b6), per-bound failure counts, and timing measurements like 'in about 26 s with the load average near 15' — that is project-specific but heavily padded. It is not a 1 because almost none of it explains concepts Claude already knows; it is noticeably verbose with much that could be trimmed or moved to reference files.

2 / 5

Actionability

Commands are copy-paste ready and cover the common cases: 'pnpm check:authored-order', flag forms like '--marks=3', '--blocks=3', '--family=lift', '--giveback-script=<script>', '--lower', plus the sync-check 'git log --oneline b2228e62ef..HEAD -- ...'. A real failure output is shown with its exact format, and expected document counts and exit behavior are given for each bound.

5 / 5

Workflow Clarity

The four modes are sequenced up front ('check... deep... lower... update...') and the failure path has explicit checkpoints: unchecked documents exit 1 before anything else, triage into real bug / modeling error / intended change, then fix and run '--lower', with validation rules ('--lower' refuses a new entry, the baseline never grows). It misses 5 because the workflow is scattered across very long sections and the density makes the sequence hard to follow on first read.

4 / 5

Progressive Disclosure

There are no bundle files at all, and content that clearly belongs in separate references — the full Findings history, the coverage-record tables, and the planted-bug results — is inlined in the SKILL.md itself. Section headers are clear and consistently used, which lifts it above the 'minimal structure' of a 2, but a 186-line monolith with obvious extractable material cannot score higher.

3 / 5

Total

14

/

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 highly specific, well-triggered description that explicitly states both what the check verifies and four concrete use conditions, in third person. Its only weakness is density: the property statement is packed and reads with effort, which keeps specificity and trigger coverage at 4 rather than 5.

DimensionReasoningScore

Specificity

The description states two concrete verification actions in third person — 'deciding the authored review tree's pending changes one at a time, in any order, gives the document that deciding them all at once gives' and 'no change adds a set of verdicts a reviewer can only decide together, for every document up to a bound'. It falls short of the 5 anchor because it names one checking activity rather than multiple distinct concrete actions, and its phrasing is dense enough that the actions take effort to parse.

4 / 5

Completeness

It explicitly answers both questions: the 'what' is the order-independence and coupled-set property checked 'for every document up to a bound', and the 'when' opens with 'Use before and after changing... or another file in its coverage record, when the authored-order step of pnpm check fails, when fixing a decision-order bug, or when recording gains a new kind of mark' — concrete trigger phrases throughout.

5 / 5

Trigger Term Quality

Triggers like 'when the authored-order step of pnpm check fails', 'when fixing a decision-order bug', 'when recording gains a new kind of mark', and the concrete path 'packages/plitejs/src/authored/tree/resolve.ts' are the natural phrases this repo's developers would say. It lacks the synonyms and variations of the 5 anchor, so it sits at good-but-not-comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is unmistakable — 'authored review tree', a specific resolver file path, and the named 'authored-order' check step — so it is clearly distinguishable from any other skill and would not trigger for the wrong one.

5 / 5

Total

18

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

12

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/authored-decision-order/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.