CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engineering-mission-playbook

Use when planning or replanning engineering missions that create, change, port, migrate, integrate, or preserve durable codebase behavior across UI, API, CLI, background jobs, data/migrations, libraries, or operator workflows. Defines investigation, scope inventory, coherent VAL-* contracts, evidence floors, multi-target task topology, engineering validation, root-cause patching, and durable guidance. For pure metric search, use optimization-mission-playbook instead.

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

70%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 a well-sequenced, highly actionable normative playbook with explicit validation checkpoints, feedback loops, and checklists — workflow clarity is excellent. Its weaknesses are substantial cross-section redundancy (parity rules and invariants restated up to five times) and a fully monolithic structure with no reference-file split despite ~280 lines of clearly separable content.

Suggestions

Deduplicate the porting/parity requirements that appear nearly verbatim in sections 1, 3, 4, 5, and 8 — state them once authoritatively (e.g., in the contract method or validation section) and reference that statement elsewhere, and consider replacing section 8's anti-patterns list (which restates section 1's invariants) with pointers to the invariant each anti-pattern violates.

Split clearly separable material into one-level-deep reference files — e.g., references/contract-template.md for the VAL-* template and field semantics, references/validation-methods.md for validator lanes and per-surface evidence requirements, and references/task-topology.md for the work/validate/gate planning rules — keeping SKILL.md as a concise overview with well-signaled links.

Add one worked example of a real VAL-* assertion (filled Surface/Needs/Behavior/Evidence fields for a concrete scenario) so workers can pattern-match correct granularity, since the current template alone leaves the distinction between compact assertions and broad buckets abstract.

DimensionReasoningScore

Conciseness

Individual sections are dense and normative without explaining concepts Claude already knows, but the same rules are restated many times: porting/parity and golden-corpus requirements appear nearly verbatim across sections 1, 3, 4, 5, and 8, and the ~20-bullet anti-patterns list in section 8 largely restates section 1's invariants and section 5's validation rules. Mostly efficient but could be tightened considerably fits anchor 3; not 2 because the prose is information-rich rather than padded filler, not 4 because the cross-section redundancy is substantial rather than minor.

3 / 5

Actionability

Provides concrete, specific guidance: a copy-paste-ready VAL-* assertion template with exact field names (Surface, Needs, Behavior, Evidence), exact artifact paths (contract/<ID>.md, MEMORY.md, AGENTS.md, decisions/), defined task types (work/validate/gate), and a pre-submit_plan checklist. Mostly executable with minor gaps fits anchor 4; not 5 because there is no worked example of a real assertion or mission, and runtime mechanisms (submit_plan, advance_project, contract-review) are invoked without any invocation detail.

4 / 5

Workflow Clarity

Section 2 gives a numbered 14-step operating order with an explicit replan protocol ("trace the issue back to the earliest invalid step"), mandatory adversarial contract review before task planning, validation-before-gate ordering, evidence-only closure, and a feedback loop ("diagnose the root cause and patch the earliest invalid artifact"), plus a pre-submit checklist in section 6. This matches anchor 5's clear sequence with explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The 8-section structure is well organized, but the ~280-line skill is entirely monolithic — no references/, scripts/, or assets/ files exist, and clearly separable material (the assertion template and contract-review checklist, validation methods, the anti-pattern catalog) is inlined rather than split into one-level-deep reference files. Some structure but content that should be separate is inline fits anchor 3; not 4 because a 280-line single file is not appropriately placed content, not 2 because section headers and numbering provide real navigation.

3 / 5

Total

15

/

20

Passed

Description

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

The description is strong: it has an explicit, specific "Use when" clause with concrete verbs and surfaces, a clear statement of what the playbook defines, and explicit disambiguation from the sibling optimization skill. Its main weaknesses are jargon-heavy process terms in the what-clause and a broad trigger surface that could overlap with general engineering work, plus a few missing natural synonyms like "refactor" or "implement".

DimensionReasoningScore

Specificity

Enumerates concrete verbs ("create, change, port, migrate, integrate, or preserve durable codebase behavior") and concrete surfaces ("UI, API, CLI, background jobs, data/migrations, libraries, or operator workflows"), but the second sentence's list ("evidence floors", "multi-target task topology", "durable guidance") names process artifacts abstractly rather than describing concrete actions. Several specific actions with minor gaps fits anchor 4; not 5 because the "Defines..." list is less concrete than a fully actionable capability list.

4 / 5

Completeness

Explicitly answers "when" with concrete trigger phrasing ("Use when planning or replanning engineering missions that create, change, port, migrate, integrate, or preserve durable codebase behavior across...") and "what" ("Defines investigation, scope inventory, coherent VAL-* contracts, evidence floors..."), plus a negative boundary to a sibling skill. Both what and when are explicitly stated with concrete triggers, matching anchor 5 rather than 4 where the when would be less specific.

5 / 5

Trigger Term Quality

Contains natural phrases users would say — "planning or replanning", "port", "migrate", "integrate", "UI", "API", "CLI", "migrations", "libraries" — plus an explicit redirect trigger ("For pure metric search, use optimization-mission-playbook instead"). Good coverage with a few natural terms missing (no "refactor", "implement", "fix", or "test" synonyms) fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (engineering mission planning within a specific orchestration ecosystem) with explicit sibling disambiguation ("For pure metric search, use optimization-mission-playbook instead") keeps it mostly distinct. Not 5 because "create, change... durable codebase behavior" is broad enough to overlap with many general coding and planning skills, matching anchor 4's minor overlap risk.

4 / 5

Total

17

/

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

jomi-se/bookhand

Path

.agents/skills/engineering-mission-playbook/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.