CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aif-plan-overview

Summarize an existing fast/full/ultra/fix plan and show its planned file changes without implementing or editing it. Use for a plan overview, file map, or a quick explanation before implementation.

Quality

85%

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

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.

A well-engineered instruction-only skill: the workflow is clearly sequenced with explicit validation and fallback handling, and supporting material is properly split into real, one-level-deep references. The main residual costs are mild redundancy in the reference-resolution and precedence prose and a couple of steps (awk extraction, manual tree drawing) described rather than given as runnable commands.

Suggestions

Provide the literal extraction command (e.g., the fixed awk expression or a bounded Read recipe) instead of the abstract 'fixed `awk`, or heading searches + bounded Read ranges', so phase-section extraction is copy-paste ready.

Deduplicate the reference-resolution instructions (stated in both section 1 and section 3) and compress the skill-context precedence paragraph to reduce token cost.

Add one compact example of a rendered tree (with the +/~/-/?/* legend and the planned-paths footer) so the manual fallback path is unambiguous when the helper cannot run.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of explanations of concepts Claude already knows ('Never run implementation discovery's mutation steps', 'A checked box is planned progress, not proof that tests passed'). Minor trim opportunities remain: reference resolution is stated twice ('Resolve this reference beside the installed entrypoint' in section 1 and 'resolve this trusted installed helper beside this entrypoint' in section 3) and the precedence paragraph in the skill-context section is boilerplate-heavy.

4 / 5

Actionability

Concrete guidance throughout: exact invocation 'Run `python3 -I -B <helper>` with JSON on stdin', a complete JSON input example, exact config keys with defaults ('.ai-factory/PLAN.md', '.ai-factory/plans/', ...), and exact continuation commands ('/aif-implement @<entrypoint>', '/aif-verify'). It falls short of fully copy-paste-ready because section extraction names techniques ('Batch section extraction when practical (fixed `awk`, or heading searches + bounded Read ranges)') without a literal command, and the manual-tree fallback has no worked example.

4 / 5

Workflow Clarity

Clear numbered sequence (resolve context -> read just enough -> present summary and file map) with prerequisite reading order and explicit validation checkpoints ('Validate the ultra marker and the existence/containment of Phase Index links first'). Error recovery and stop conditions are explicit at nearly every step ('If sections are absent, say which phase lacks a file/objective summary'; 'If Python/helper execution is unavailable or not permitted, draw the same tree manually'; 'a missing reference stops discovery'). The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

The body is an overview that cleanly offloads detail to two well-signaled, one-level-deep references that both exist on disk: [read-only discovery](references/PLAN-OVERVIEW-DISCOVERY.md) and [file_tree.py](references/plan-overview/file_tree.py). PLAN-OVERVIEW-DISCOVERY.md contains no further nested bundle references, navigation is easy, and content is appropriately split.

5 / 5

Total

18

/

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.

A strong description: third-person, concise, and precise, with an explicit 'Use for' trigger clause and a clear non-implementation boundary that distinguishes it from sibling workflow skills. The only gaps are slightly broader trigger-synonym coverage and just two core actions named.

DimensionReasoningScore

Specificity

Concrete actions are explicit: 'Summarize an existing fast/full/ultra/fix plan', 'show its planned file changes', 'without implementing or editing it', with the domain enumerated across all four plan modes and an explicit non-goal. It sits above anchor 3's generic partial coverage but below anchor 5, which expects multiple distinct actions rather than two.

4 / 5

Completeness

Both questions are explicitly answered: what ('Summarize an existing fast/full/ultra/fix plan and show its planned file changes without implementing or editing it') and when ('Use for a plan overview, file map, or a quick explanation before implementation') with concrete trigger phrases. The 'when' clause is explicit and specific, not merely implied, so anchor 4's caveat does not apply.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'Use for a plan overview, file map, or a quick explanation before implementation', plus 'summarize' and 'planned file changes'. A few natural variations are missing (e.g., 'explain this plan', 'what will this plan change'), so it does not reach comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The clause 'without implementing or editing it' plus the overview/file-map framing carves a clear niche distinct from implementation or fix skills. Minor overlap risk remains with sibling plan-management skills that share the 'plan' keyword family, preventing a minimal-conflict score of 5.

4 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

lee-to/ai-factory

Path

skills/aif-plan-overview/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.