CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alignment-checkpoint

Create or review an explicit pre-action alignment checkpoint. Use when the user requests a checkpoint or an unresolved decision materially changes scope, risk, or authority; ordinary bounded implementation does not require a checkpoint.

Quality

81%

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

81%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 tight, well-structured process skill: clear trigger boundaries, a sequenced workflow with explicit validation gates, and well-signaled one-level-deep references. It loses points only on small margins — repeated authority statements, one garbled phrase, no example checkpoint output, and an unreferenced bundle file.

Suggestions

Add a short example checkpoint output (goal/assumptions/open decision/holding action, with `schema_version`) to make the Outputs section copy-paste concrete.

Fix or delete the garbled directive "continue no unchanged retry loop" and trim the authority-preservation point to one section to tighten conciseness.

Either reference or account for the unreferenced references/task-profile.json in the bundle, and fold the historical Infrastructure path into a single reference note.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — e.g., "Hold only the affected action. Continue independent authorized work." — with no explanation of concepts Claude already knows. It falls short of anchor 5 only through minor trimmable material: the authority-preservation point is repeated across Failure Mode ("do not begin unrelated repair work"), Validation ("Confirm that existing authorization was preserved"), and Execution Boundaries ("Do not infer authority for destructive changes..."), and the Validation bullet about auditing the skill when it changes is maintenance guidance rather than runtime instruction. Comfortably above a 3, which would require noticeable padding or over-explanation.

4 / 5

Actionability

For an instruction-only skill, guidance is mostly executable: the Workflow gives concrete directives ("Inspect only relevant read-only evidence unless the user prohibited tools", "ask only what changes scope, risk, or authority") and Outputs specifies concrete artifacts ("A concise statement of the goal, assumptions, and success criteria", "schema-bound outputs include `schema_version`"). Not a 5 because no example or template of an actual checkpoint output is provided, and a few directives stay abstract ("State the decision and consequences") plus one garbled line ("continue no unchanged retry loop"); clearly above a 3 since the steps are specific and followable rather than pseudocode-level.

4 / 5

Workflow Clarity

The five-step Workflow is clearly sequenced with explicit validation gates and an error-recovery stance: "Fail fast: stop at the first failed gate; do not proceed with the affected action until its required check passes", plus output checks ("Check that the output names the unresolved decision and the affected action") and explicit failure-mode handling ("If evidence is unavailable, state the uncertainty and ask the necessary question"). This matches anchor 5's 'Clear sequence with explicit validation steps; feedback loops for error recovery'. The skill is non-destructive by design (it gates destructive action), so no validation cap applies.

5 / 5

Progressive Disclosure

The References section clearly signals one-level-deep, existing files — "references/contract.yaml: inputs, outputs, trigger boundaries, and safety" and "references/evals.yaml: explicit holds, material decisions..." (both verified present) — and gates deeper historical material ("inspect a specific file only when the current decision requires it"). Not a 5 because of two minor gaps measured against the actual bundle: references/task-profile.json exists in the bundle but is never mentioned or navigated to, and the external "Infrastructure/references/deferred-skill-context/..." path is an extra indirect layer. Well above a 3, which would require inline content that belongs in a separate file.

4 / 5

Total

17

/

20

Passed

Description

71%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-formed description that clearly and explicitly answers both what the skill does and when to use it, including a useful negative trigger boundary. It is slightly held back by modest action coverage and reliance on a single natural trigger phrase, plus a small collision risk on the generic word 'checkpoint'.

Suggestions

Broaden the 'what' beyond 'create or review' with one or two concrete checkpoint contents (e.g., 'state the goal, assumptions, open decision, and the action holding on it') to raise specificity.

Add natural user phrasings to the trigger, such as 'confirm before acting', 'pause and get approval', or 'check with me before', to improve trigger-term coverage.

Qualify 'checkpoint' (e.g., 'alignment checkpoint (pre-action confirmation), not CI or model checkpoints') to reduce distinctiveness overlap.

DimensionReasoningScore

Specificity

"Create or review an explicit pre-action alignment checkpoint" names the domain plus two concrete actions (create, review), but does not enumerate what the checkpoint contains or does beyond that, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. Not a 4 because it lacks the several-specific-actions coverage of 'Lists several specific actions; minor gaps in coverage'; clearly above a 2 because the domain and actions are concrete, not generic.

3 / 5

Completeness

Both questions are answered explicitly and concretely: what — "Create or review an explicit pre-action alignment checkpoint"; when — "Use when the user requests a checkpoint or an unresolved decision materially changes scope, risk, or authority", plus an explicit negative boundary "ordinary bounded implementation does not require a checkpoint". This matches anchor 5 ('Clearly and explicitly answers both what AND when with concrete trigger phrases'); a 4 would require the 'when' to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

"Use when the user requests a checkpoint" captures the core natural phrase, and "unresolved decision materially changes scope, risk, or authority" gives a semantic condition, but common natural variations users would actually say — "confirm before you act", "pause and check with me", "get my approval", "sign-off" — are absent. This fits 'Some relevant keywords but missing common variations or synonyms' rather than anchor 4's 'Good keyword coverage; a few natural terms missing', since only one natural trigger phrase is present.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — "pre-action alignment checkpoint" with scope/risk/authority triggers and an exclusion clause for ordinary work — but "checkpoint" is also a common term in other domains (CI, ML training checkpoints, project milestones), creating minor overlap risk with related planning/review skills. Fits anchor 4 ('Mostly distinct; minor overlap risk with closely related skills') rather than 5, since the single keyword trigger is not unambiguous.

4 / 5

Total

15

/

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

jscraik/Agent-Skills

Path

Skills/agent-ops/alignment-checkpoint/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.