CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

new-project-bootstrap

Comprehensive bootstrap flow for a brand-new project. Begins with a deep-dive architectural conversation, then runs a plan → implement → review chain, and finally writes the initial UML.md. Load this when the user starts pi in an empty or near-empty directory, or when explicitly asked to bootstrap a new project.

Quality

92%

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

96%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.

An exemplary process skill: lean, fully actionable, and sequenced with explicit validation checkpoints and feedback loops at every phase boundary. The only dimension short of top marks is progressive disclosure, and that is a threshold technicality of line count rather than a real organizational flaw. No bundle files exist, and none are needed.

DimensionReasoningScore

Conciseness

Lean throughout: literal question batches, a compact plan.md skeleton, and terse guardrails ("Do not invent product requirements the user did not state") with zero explanation of concepts Claude already knows. Matches 'every token earns its place'; the only candidate for trimming is the opening trigger sentence, which restates the description but is a single line.

5 / 5

Actionability

Fully executable for an instruction-only skill: 12 literal questions to ask, a copy-paste-ready plan.md markdown template, and explicit directives ("Do not start writing code before phase 3"). Per the scoring notes, absence of code is not penalized when guidance is this concrete; nothing is left as vague direction.

5 / 5

Workflow Clarity

Four phases in strict order with explicit checkpoints and feedback loops: "ask the user to confirm before moving to phase 2", "Get explicit approval before phase 3", "If reality contradicts the plan, stop and update the plan before continuing", plus a phase-4 self-review/build/smoke-test loop and a checklist in the plan template. Matches the anchor-5 example (clear sequence, explicit validation, error-recovery loops); no destructive or batch operations apply a cap.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear section headers and all content genuinely belonging inline; no buried or nested references. Not 5 because the body is ~78 lines — above the under-50-line threshold where the rubric allows a 5 without external file structure — so material like the question bank or plan template could arguably live in a reference file; not 3 because nothing that should be separate is inlined and navigation is unambiguous.

4 / 5

Total

19

/

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 voice, concrete action sequence, and an explicit dual-condition trigger clause. Main weaknesses are minor — the actions are named but stay high-level, and a few natural synonyms (scaffold, initialize) are missing. Scored at or near the top on all dimensions.

DimensionReasoningScore

Specificity

Names several concrete actions — "deep-dive architectural conversation", "plan → implement → review chain", "writes the initial UML.md" — matching the 'several specific actions; minor gaps in coverage' anchor. Not 5 because the actions are described at a high level (no detail on what the conversation covers or what the review entails), and the opener "Comprehensive bootstrap flow" is mildly generic.

4 / 5

Completeness

Explicitly answers both: what ("architectural conversation, then... plan → implement → review chain, and finally writes the initial UML.md") and when ("Load this when the user starts pi in an empty or near-empty directory, or when explicitly asked to bootstrap a new project") with concrete trigger phrases. Clearly matches the anchor-5 example structure; anchor 4's caveat ('when' could be more explicit) does not apply since the when-clause is specific and conditional.

5 / 5

Trigger Term Quality

Includes natural phrases users would say: "bootstrap a new project", "brand-new project", "empty or near-empty directory". Not 5 because common variations like "scaffold", "initialize", or "start a new project" are absent and "starts pi" is a harness-specific term rather than a user utterance; not 3 because coverage of natural terms is solid, not just partial.

4 / 5

Distinctiveness Conflict Risk

The trigger condition "empty or near-empty directory" carves out a fairly distinct niche, but "bootstrap a new project" overlaps with project-init/scaffolding skills, matching 'mostly distinct; minor overlap risk with closely related skills'. Not 5 because a generic 'new project' request could plausibly match an init-type skill instead.

4 / 5

Total

17

/

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

g23polar/pi-project-memory

Path

skills/new-project-bootstrap/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.