CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pre-impl-discussion

Conduct a thorough pre-implementation discussion before making significant changes. Use when the user wants to discuss, plan, or evaluate a change before implementing it — especially when they say words like 'discuss', 'evaluate', 'plan', or 'let's talk about'.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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, lean procedural skill with an explicit confirmation gate and iteration loop, and it appropriately needs no bundle files. Its only weaknesses are minor: the Anti-Patterns table duplicates guidance already given inline, and no concrete example shows what findings or decision points should look like.

Suggestions

Trim the overlap between the step 5 'Common mistakes' bullets and the Anti-Patterns table (e.g., 'repeating the full plan' and 'answering broadly' appear in both) — keep one location and reference it.

Add one compact example of a decision-point presentation (2-3 options with a one-sentence lean) so the step-4 guidance is copy-paste concrete rather than purely descriptive.

Consider folding the anti-patterns that restate the verification rule into step 2 to avoid re-teaching the same rule twice.

DimensionReasoningScore

Conciseness

The body is imperative and lean with no concept explanations Claude already knows ("Read the relevant source files", "Verify every claim with evidence"). However, the Anti-Patterns table repeats points already made in the procedure ("Repeating the full plan in every response" duplicates step 5's 'Common mistakes'; "Say 'X should work' without checking" duplicates step 2's verification rule) — minor redundancy that could be trimmed, matching 'Efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean level 5.

4 / 5

Actionability

As an instruction-only skill the guidance is concrete and executable: exact step behaviors ("Read the relevant source files", "Present them as clear choices with trade-offs", 2-3 options max, "stop and wait" after the final plan). It falls short of level 5 only in lacking a concrete example of the expected output (e.g., a sample findings table or decision-point format), leaving minor gaps per 'Mostly executable guidance; concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

The seven-step procedure is clearly sequenced with an explicit validation gate (step 7: "After presenting the final plan, stop and wait") and a feedback loop routing unconfirmed questions back to step 5 ("Ask more questions → go back to step 5"). The Anti-Patterns table functions as a checklist. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists' — the 'user confirmation' checkpoint is the appropriate validation for a non-destructive discussion skill, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and none are needed: the body is a compact procedural guide with well-organized sections (Golden Rule, Interaction Style, numbered Procedure, Anti-Patterns) and no bulk reference material that belongs in a separate file. Content is appropriately contained in the single SKILL.md, matching the well-organized-sections standard for skills needing no external references.

5 / 5

Total

18

/

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.

The description explicitly answers both what the skill does and when to use it, with natural quoted trigger phrases — a strong trigger design. Its main weakness is specificity: it names the discussion activity but not the concrete behaviors the discussion involves, slightly weakening distinctiveness against adjacent planning skills.

Suggestions

Enumerate 1-2 more concrete capabilities in the description (e.g., 'researches constraints from official sources, maps the impact surface, and presents options with trade-offs') to raise specificity from naming one action to several.

Add missing natural trigger variations users might say, such as 'talk through', 'what do you think about', or 'before you start coding', to broaden trigger-term coverage.

Sharpen distinctiveness by emphasizing the no-implementation gate (e.g., 'discussion only — no code changes until the user confirms the plan') to separate it from general planning skills.

DimensionReasoningScore

Specificity

"Conduct a thorough pre-implementation discussion before making significant changes" names the domain and one main action (facilitating a discussion) but does not enumerate what the discussion covers (researching sources, mapping impact surface, presenting options with trade-offs). It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — below level 4, which requires several specific listed actions, and above level 2 because the action named is concrete rather than generic.

3 / 5

Completeness

The 'what' is explicit ("Conduct a thorough pre-implementation discussion before making significant changes") and the 'when' is explicit with concrete trigger phrases ("Use when the user wants to discuss, plan, or evaluate a change before implementing it — especially when they say words like..."). This matches the level-5 anchor: both what AND when clearly answered with concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases are present: "'discuss', 'evaluate', 'plan', or 'let's talk about'" — terms a user would naturally say. A few common variations are missing (e.g., 'talk through', 'brainstorm', 'what do you think about', 'before you start'), so it sits at 'Good keyword coverage; a few natural terms missing' rather than the comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

The pre-implementation-discussion niche is fairly clear and anchored to a distinct phase (before implementation), but trigger words like 'plan' and 'evaluate' overlap with general planning/architecture skills. This is 'Mostly distinct; minor overlap risk with closely related skills' — below level 5's 'clear niche with distinct triggers' because 'plan' is a common word many skills could claim.

4 / 5

Total

16

/

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

Mirxa27/Mirxa-agent

Path

.agents/skills/pre-impl-discussion/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.