CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-1-initiate-planner

Initiate an APM Planner. Use only when the User manually invokes this skill.

Quality

82%

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

88%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 an exemplary lean orchestration skill: a clearly numbered workflow with explicit user-approval checkpoints, concrete file-system deliverables, and well-signaled deferral of methodology detail to external guides. Its only weaknesses are that the planning substance lives entirely in the referenced guides and that reference paths are templated placeholders, leaving slight dependence on content outside this file.

DimensionReasoningScore

Conciseness

The body is lean and instruction-dense: every paragraph carries directives ("Read these files in full", "Create `.apm/bus/<agent-slug>/`", "Keep each approval gate"), and the APM methodology background ("Workers do not read the Spec or Plan") is novel context Claude cannot know, not padding. This matches anchor 5 (lean, assumes competence, every token earns its place) rather than 4 because there is no over-explanation to trim.

5 / 5

Actionability

Guidance is mostly executable: exact bus file structure ("empty `task.md`, `report.md` and `handoff.md`, and `.apm/bus/manager/` with only an empty `handoff.md`"), a named next skill ("invoking `apm-2-initiate-manager`"), and a concrete survey checklist (Git status, branches, `.apm/archives/`, `AGENTS.md`). It is anchor 4 rather than 5 because the planning substance itself is deferred to the external guides, so common-case coverage is not fully contained in this file.

4 / 5

Workflow Clarity

The five numbered sections sequence Initiation → Workspace Survey → Planning → Completion → Subagents, with explicit stop-and-wait checkpoints at every phase transition ("end your message and wait for the reply", "wait for the User to approve each one before you start the next", "Keep each approval gate unless the User explicitly asks to skip it"). These approval gates are the explicit validation steps of anchor 5; no destructive or batch operation applies a cap.

5 / 5

Progressive Disclosure

The file is a well-organized overview with purpose-annotated, one-level-deep references ("`{GUIDE_PATH:context-gathering}`: how to explore the workspace and question the User") and scoped reading guidance ("Read other APM files only when these files point you to them"). It is anchor 4 rather than 5 because the reference targets are unresolved template placeholders rather than verifiable paths, and reading chains through the guides; no bundle files are present to verify the structure against.

4 / 5

Total

18

/

20

Passed

Description

66%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 is distinctive and has an explicit trigger condition, but it undersells the skill: the actual work (context gathering, question rounds, writing the Spec, Plan and Rules) is invisible, and the trigger is stated only as manual invocation with no natural user phrasing. It is functional and conflict-free, yet thin on capability detail.

Suggestions

State the concrete deliverables in the description, e.g. "Initiate an APM Planner that explores the workspace, questions the User, and writes the Spec, Plan and Rules documents."

Add natural trigger phrases users would actually say, such as "Use when the user asks to start or initiate APM planning for a project" (the manual-invocation restriction can stay as a secondary clause).

Keep third-person, concrete verbs for each capability rather than the single generic verb "Initiate", so the description alone conveys what the skill does end to end.

DimensionReasoningScore

Specificity

"Initiate an APM Planner" names the domain and one concrete action, but never states the skill's actual capabilities (exploring the workspace, questioning the User, writing the Spec, Plan and Rules). It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 2 because a real action is named, and not 4 because only one action is listed with no coverage of the rest.

3 / 5

Completeness

Both parts are present: "Initiate an APM Planner" answers what, and "Use only when the User manually invokes this skill" is an explicit when-clause, so the missing-trigger cap does not apply. It sits at anchor 4 (both present, each could be more specific) rather than 5 because the what omits the deliverables and the trigger is not a natural user phrase, and rather than 3 because the when is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Terms like "APM Planner", "initiate" and "manually invokes this skill" are relevant and domain-specific, but natural user variations ("start the planner", "plan this project", "kick off APM") are missing. This is anchor 3 (some relevant keywords, missing common variations or synonyms), not 2 because the keywords are specific rather than generic, and not 4 because coverage is thin.

3 / 5

Distinctiveness Conflict Risk

"APM Planner" is a clear niche role, and "Use only when the User manually invokes this skill" removes any auto-trigger conflict risk with other skills. This clearly matches anchor 5 (clear niche with distinct triggers, minimal conflict risk).

5 / 5

Total

15

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

sdi2200262/agentic-project-management

Path

templates/skills/apm-1-initiate-planner/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.