CtrlK
BlogDocsLog inGet started
Tessl Logo

update-implementation-plan

Update an existing implementation plan file with new or update requirements to provide new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.

53

5.44x
Quality

27%

Does it follow best practices?

Impact

98%

5.44x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/project-planning/skills/update-implementation-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 provides a general sense of the skill's purpose — updating implementation plans — but lacks concrete actions, explicit trigger guidance, and natural user-facing keywords. It reads as a single run-on sentence that tries to cover too many vague domains (design, architecture, infrastructure) without clearly distinguishing itself or telling Claude when to select it.

Suggestions

Add an explicit 'Use when...' clause with trigger terms like 'update plan', 'revise implementation plan', 'add new requirements to plan', 'modify plan file'.

List specific concrete actions the skill performs, e.g., 'Adds new feature requirements to an existing plan, marks completed tasks, restructures plan sections for refactoring or package upgrades'.

Narrow the scope language — replace vague terms like 'design, architecture or infrastructure' with specific examples or remove them to reduce conflict risk with other skills.

DimensionReasoningScore

Specificity

It names the domain (implementation plan files) and some actions (update with new requirements, refactoring, upgrading packages), but the actions are broad and not concretely enumerated — 'design, architecture or infrastructure' is vague.

2 / 3

Completeness

It describes 'what' at a high level but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'what' itself is also vague enough to push this to 1.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'implementation plan', 'refactoring', 'upgrading packages', but misses common natural user phrases like 'update plan', 'revise plan', 'add requirements', or file format references. The terms are somewhat generic.

2 / 3

Distinctiveness Conflict Risk

The mention of 'implementation plan file' provides some specificity, but terms like 'design, architecture or infrastructure' and 'refactoring existing code' are broad enough to overlap with general coding, architecture, or project management skills.

2 / 3

Total

7

/

12

Passed

Implementation

22%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a detailed template for implementation plans but fails at its stated purpose of *updating* existing plans. It is heavily padded with meta-instructions about AI-to-AI communication and deterministic execution that add no value. The core weakness is the absence of any workflow for the update process itself—how to read, diff, merge, and validate changes to an existing plan file.

Suggestions

Add a clear step-by-step workflow for updating an existing plan: read current file → identify what changed → merge new requirements → validate template compliance → write updated file

Remove the verbose meta-instructions about AI agent execution, deterministic language, and machine-parseable formats—these are unnecessary padding that Claude doesn't need

Add specific guidance on update scenarios: adding new phases, marking tasks complete, changing status, adding new requirements to existing sections, handling conflicts

Include a validation checklist or checkpoint after the update to verify the modified plan still adheres to the template structure

DimensionReasoningScore

Conciseness

Extremely verbose with significant redundancy. Phrases like 'AI-to-AI communication and automated processing', 'deterministic language with zero ambiguity', and 'machine-parseable formats' are repeated conceptually multiple times. The meta-instructions about AI agent execution are unnecessary padding—Claude doesn't need to be told it's an AI agent or that instructions should be 'interpreted literally.' The template itself is useful but is wrapped in excessive preamble.

1 / 3

Actionability

The template structure is concrete and provides a clear markdown format to follow, which is actionable. However, the skill is about *updating* an existing plan, yet provides almost no guidance on how to merge new requirements into existing content, how to handle conflicts, or what specific operations to perform on the existing file. The template is copy-paste ready but the actual update workflow is vague.

2 / 3

Workflow Clarity

There is no clear workflow for the update process itself. The skill describes what the output should look like but never sequences the steps: read existing plan → identify changes → merge requirements → validate structure → write output. There are no validation checkpoints, no error recovery steps, and no guidance on handling conflicts between existing and new content.

1 / 3

Progressive Disclosure

The content is organized with headers and sections, but it's essentially a monolithic document. The large template could be split into a separate reference file. There are no references to external files, which is acceptable given no bundle, but the inline template makes the skill quite long. The section organization is reasonable but the template dominates the content.

2 / 3

Total

6

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
github/awesome-copilot
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.