CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-execute-plan

This skill should be used when the user says "execute plan", "run the plan", "start execution", "execute project", "execute all tasks", "run all tasks", "run plan in parallel", "execute with review gates", or wants to execute a full structured project plan after tasks have been created via arn-code-taskify. This skill runs ALL tasks from the task list — for executing a single specific task, use arn-code-execute-task instead. For Agent Teams mode, use arn-code-execute-plan-teams. Do NOT use this skill when executing a single task — use `/arn-code-execute-task` instead.

74

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-execute-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description excels at trigger term coverage and disambiguation from related skills, making it very effective for skill selection in a large skill library. Its main weakness is that it focuses heavily on when to use/not use the skill but provides relatively little detail about what concrete actions the skill performs during plan execution (e.g., dependency resolution, progress tracking, error handling). The description is functional and well-targeted but could benefit from more specificity about capabilities.

Suggestions

Add 2-3 concrete capability descriptions beyond 'runs ALL tasks' — e.g., 'resolves task dependencies, tracks progress, handles parallel execution, and applies review gates between phases.'

DimensionReasoningScore

Specificity

The description names the domain (executing a structured project plan with all tasks) and mentions some actions like running tasks in parallel and using review gates, but it doesn't list multiple concrete actions beyond 'runs ALL tasks from the task list.' The actual capabilities (what it does during execution) are not well-described.

2 / 3

Completeness

Clearly answers both 'what' (runs all tasks from a task list created via arn-code-taskify) and 'when' (explicit trigger phrases plus clear guidance on when NOT to use it, with pointers to alternative skills). The explicit 'Use when' equivalent and disambiguation from related skills is strong.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger phrases: 'execute plan', 'run the plan', 'start execution', 'execute project', 'execute all tasks', 'run all tasks', 'run plan in parallel', 'execute with review gates'. These are phrases users would naturally say and cover multiple variations.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit disambiguation from two related skills (arn-code-execute-task for single tasks, arn-code-execute-plan-teams for Agent Teams mode). The repeated clarification about single task vs. all tasks makes conflict very unlikely.

3 / 3

Total

11

/

12

Passed

Implementation

47%

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

This skill has excellent workflow clarity with well-defined steps, validation checkpoints, and comprehensive error recovery paths. However, it suffers from significant verbosity — the error handling section, user prompts, and detailed branching logic inflate the token cost substantially. Much of this detail could be offloaded to reference files, improving both conciseness and progressive disclosure.

Suggestions

Move the extensive error handling section (especially the test failure branches with full AskUserQuestion prompts) to a reference file like `references/error-handling.md` and summarize inline with a brief table of error → action mappings.

Trim inline AskUserQuestion prompt text to just the option names/descriptions — Claude can compose natural-language prompts from concise specifications without needing the exact wording spelled out.

Add a brief inline summary of the dispatch loop algorithm (3-4 lines) before the reference file pointer so the reader understands the pattern without needing to open the reference.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~200+ lines with extensive inline detail that could be offloaded to reference files. Many sections explain orchestration logic, error handling branches, and UI prompts in exhaustive detail that inflates token cost significantly. The error handling section alone contains multiple multi-paragraph branches with full prompt text that could be in a reference file.

1 / 3

Actionability

The skill provides concrete steps, specific file paths, and exact prompts to present to users, which is good. However, the core dispatch loop (Step 4) delegates entirely to an external reference file with no inline summary of the algorithm, and there's no executable code — just directory structures and procedural descriptions. The guidance is specific but not copy-paste executable.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with numbered steps, explicit validation checkpoints (verify project directory, check task list, confirm before execution), feedback loops (execute-review-gate cycle with retry/escalate), and comprehensive error handling with branching recovery paths. The dependency graph verification and review cycle max-retry escalation demonstrate strong validation discipline.

3 / 3

Progressive Disclosure

The skill correctly references external files for the dispatch loop and pattern refresh procedure, which is good progressive disclosure. However, the error handling section is a massive inline block that should be in a reference file, and the bundle files are not provided so we cannot verify the referenced paths exist. The overall structure would benefit from moving detailed error branches and user prompts to reference documents.

2 / 3

Total

8

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.