CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-page

Write, check, repair and publish a plan page: a project's plans and subject files under its plans directory, rendered by .agents/pstack/plan-page.mjs and rendered as one local HTML page per subject with a local index of every subject, and published to claude.ai at each hand-back for comments and feedback. The page is how planned work hands back to the user. Use before writing or changing a plan, a subject file in <plans>/topics or its page; at every stop that hands back work with a plan, such as a review verdict other than a review-only panel's, a next answer or a playbook's close; before writing or updating a PR body, which renders from the PR's plan, or a comment about your commits on someone else's PR; when a plan page or its claude.ai artifact looks wrong or refuses to render; to republish a page; or to change the page shape or a playbook's page sections.

Quality

81%

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

67%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 dense, command-rich operational guide: every mode has concrete commands, a dedicated Check validation gate, refuse-and-fix feedback loops, and a real, well-signaled reference file holding the file shapes. Its weaknesses are run-on sentences that stack many rules per step, and heavy reliance on external rules and sibling skills ("the block's Plan pages rule", pstack:bro, Lesson mode) that leave the guidance not fully self-contained.

Suggestions

Split multi-rule sentences into separate steps or a short list — Render step 8 and the PR-comment steps each bury 5+ distinct rules (publish routing, --new, pinning, reading rules) in one paragraph; pulling them apart would raise conciseness without losing content.

Define or inline the minimum needed from external dependencies ("the block's Plan pages rule", "the block's Plans and trails rule", pstack:bro) at first use, or move them to references/shape.md, so the commands are executable without knowledge the file never states.

Move the detailed PR-comment and publish-routing subsections into a second reference file (e.g. references/publishing.md) and keep one-line summaries in the mode table, so SKILL.md reads as the overview the mode table promises.

DimensionReasoningScore

Conciseness

There is no padding or explanation of concepts Claude already knows, but single sentences carry many rules at once — e.g. Render step 8 packs publish routing, checkout fork rules, the `--new` flow, Defaults rows, page-reading rules, pinning and Codex behavior into one paragraph. Mostly efficient but could be materially tightened, fitting the 3 anchor better than 4, where only minor trimming would be needed.

3 / 5

Actionability

Quotes: "node .agents/pstack/plan-page.mjs <plan> --check", "gh pr view <number> --json body --jq .body > <run directory>/body.md", "gh pr edit <number> --body-file <file>", "--attach", "--public", "--into" — concrete, copy-paste-ready commands with placeholders and a YAML example. Not 5 because execution repeatedly depends on context the file does not define ("the block's Plan pages rule", "pstack:bro", "sync-pstack's Lesson mode"), leaving gaps for a reader outside that ecosystem.

4 / 5

Workflow Clarity

Quotes: "Walk [Check](#check)'s reading list before the first publish and after each revision", "It refuses every shape it can check and names the fix. Fix the plan or the subject file, never the HTML", plus a numbered Repair workflow — explicit validation checkpoints and a refuse-then-fix feedback loop are present. Not 5 because sequencing is blurred by cross-references ("Render steps 5, 7 and 8", "Render steps 3 to 6") and delegation to external rules ("as the Plan pages rule says"), so several checkpoints are implicit rather than self-contained.

4 / 5

Progressive Disclosure

The body is an overview with a mode table, and the single reference is well-signaled and one level deep: "Read [references/shape.md](references/shape.md) before writing a plan or a subject file. It holds every file shape, the page order and the renderer's refusals" — and shape.md exists with exactly those sections. Not 5 because substantial detail (publish routing in step 8, the PR-comment subsection) stays inline where a further reference split would ease navigation, a minor organization gap per the 4 anchor.

4 / 5

Total

15

/

20

Passed

Description

88%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 answers both what and when explicitly and concretely, naming the renderer command, the local/claude.ai publish targets, and PR-body and comment use cases. Its weakness is trigger phrasing steeped in one project's vocabulary ("a playbook's close", "a review-only panel's") that a user outside that workflow would not naturally say, plus broad triggers ("before writing or changing a plan") that overlap with generic planning skills.

DimensionReasoningScore

Specificity

Quotes: "Write, check, repair and publish a plan page", "rendered by .agents/pstack/plan-page.mjs", "one local HTML page per subject with a local index", "write or update a PR body", "a comment about your commits on someone else's PR". Multiple concrete actions comprehensively cover every mode of the skill, matching the 5 anchor rather than 4, whose coverage would have minor gaps.

5 / 5

Completeness

Quotes: what — "Write, check, repair and publish a plan page ... rendered as one local HTML page per subject ... published to claude.ai"; when — "Use before writing or changing a plan ... at every stop that hands back work with a plan ... before writing or updating a PR body ... when a plan page ... refuses to render ... to republish a page". Both what and when are answered explicitly with concrete trigger phrases, exactly the 5 anchor.

5 / 5

Trigger Term Quality

Quotes: "Use before writing or changing a plan", "when a plan page or its claude.ai artifact looks wrong or refuses to render", "to republish a page" — good explicit trigger coverage, but phrases like "a review verdict other than a review-only panel's" and "a playbook's close" are ecosystem jargon rather than natural user phrasing, with no synonyms or extensions. Not 5 (missing natural-term variations); clearly above 3 (most relevant triggers are present and explicit).

4 / 5

Distinctiveness Conflict Risk

Quotes: "a plan page", "which renders from the PR's plan", "the renderer" — a clear niche with distinct triggers, but "before writing or changing a plan" and "a comment about your commits on someone else's PR" could also fire for generic planning or PR-comment skills. Minor overlap with closely related skills fits the 4 anchor; not 5 because that overlap is real.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/plan-page/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.