CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-eng-review

Eng manager-mode plan review. Lock in the execution plan — architecture, data flow, diagrams, edge cases, test coverage, performance. Walks through issues interactively with opinionated recommendations. Use when asked to "review the architecture", "engineering review", or "lock in the plan". Proactively suggest when the user has a plan or design doc and is about to start coding — to catch architecture issues before implementation.

Quality

76%

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 ./skills/gstack/.agents/skills/gstack-plan-eng-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 highly actionable — executable commands, copy-paste templates, and a well-checkpointed interactive review workflow with explicit STOP gates. However, it is a ~61KB single-file monolith with no bundle files: shared framework boilerplate, background concept explanation, and the entire test-review methodology are inlined, which costs token efficiency and any meaningful progressive disclosure.

Suggestions

Extract the shared gstack framework sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, Completion Status Protocol, Telemetry) into a common base reference that this skill links to, so SKILL.md carries only the plan-review-specific workflow.

Create references/ files for the heavy detail blocks — e.g. references/test-review.md (Steps 1-5, E2E decision matrix, regression rule) and references/dashboard.md (readiness dashboard + plan-file report parsing) — and link them one level deep from a concise overview section.

Trim explanations of what Claude already knows (the data-flow tracing primer, the 15 cited Cognitive Patterns, the duplicated design-doc-check bash block) to terse directives, and fix the duplicate '5.' numbering in Step 0.

DimensionReasoningScore

Conciseness

The ~61KB/973-line body inlines large shared-framework sections ('Voice', 'AskUserQuestion Format', 'Completeness Principle', telemetry flows) and pads with explanations Claude does not need, e.g. the step-by-step data-flow tracing primer ('Where does input come from? (request params, props, database, API call)') and 15 cited 'Cognitive Patterns'. The design-doc-check bash block is even duplicated verbatim (lines 387-394 and 437-444), matching 'noticeably verbose; several unnecessary explanations or padded sections' rather than the mostly-efficient anchor 3.

2 / 5

Actionability

Fully executable guidance throughout: copy-paste bash blocks with explicit substitution instructions (preamble, gstack-review-log, telemetry), concrete output templates (ASCII coverage diagram, test-plan markdown, dependency tables, dashboard format), and precise directives like 'One issue = one AskUserQuestion call' and 'Only proceed to the next section after ALL issues in this section are resolved'. Common cases are covered by worked examples (the billing.ts coverage diagram).

5 / 5

Workflow Clarity

The sequence is explicit (Preamble -> Design Doc Check -> Step 0 Scope Challenge -> Sections 1-4 each with a STOP gate -> Required outputs -> Review Log/Dashboard -> Plan File Report) with checklists, a priority hierarchy, and feedback loops (re-run design-doc check after office-hours, retry-once on Edit failure). It falls short of anchor 5 due to the Step 0 numbering bug (two items numbered '5'), heavy interleaving of framework boilerplate with review steps, and duplicated check blocks — minor but real gaps.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and everything — generic gstack framework content (telemetry, dashboard parsing, report formats) plus the full test-review methodology — is inlined in one monolithic file, so 'content that clearly belongs in separate files is inlined' applies. It is above anchor 1 because section headers provide navigation, but pointers like $GSTACK_ROOT/ETHOS.md and TODOS-format.md are cross-skill paths, not skill-bundle references, so there is effectively no progressive disclosure.

2 / 5

Total

13

/

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 clearly and explicitly states both what the skill does and when to use it, with natural quoted trigger phrases and a proactive-suggestion condition. It is specific, in third person, and largely distinct from sibling skills; only minor keyword-coverage and overlap gaps keep it from top marks.

DimensionReasoningScore

Specificity

'Lock in the execution plan — architecture, data flow, diagrams, edge cases, test coverage, performance' and 'Walks through issues interactively with opinionated recommendations' list several concrete review actions in third person. It is not anchor 5 because the enumeration of what the review produces is not fully comprehensive, and well above anchor 3, which permits only 1-2 concrete actions.

4 / 5

Completeness

Both questions are explicitly answered: the 'what' is concrete ('Eng manager-mode plan review' across architecture, tests, performance, with interactive opinionated recommendations) and the 'when' uses concrete trigger phrases ('Use when asked to...' and the proactive-suggestion clause). This clearly matches the anchor-5 example pattern of what + explicit when with trigger phrases.

5 / 5

Trigger Term Quality

Quoted trigger phrases 'review the architecture', 'engineering review', and 'lock in the plan' are natural things a user would say, plus the proactive condition 'when the user has a plan or design doc and is about to start coding'. A few natural variants are missing (e.g. 'review my plan', 'tech design review', 'sign off on the plan'), which fits 'good keyword coverage; a few natural terms missing' rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Eng manager-mode plan review' with the 'lock in the plan' trigger carves a mostly distinct niche. Minor overlap risk remains because 'review the architecture' and 'engineering review' could plausibly fire sibling review skills (plan-ceo-review, plan-design-review, code review), matching 'mostly distinct; minor overlap risk with closely related skills' rather than anchor 5's minimal conflict risk.

4 / 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

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-plan-eng-review/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.