CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

new-project

Use when invoked as $new-project or when creating a brand-new repository or project from scratch — scaffolds mise-pinned tools, a just task surface, the standard repo files, and CI for Python (uv), TypeScript (bun), Rust (cargo), or Go.

Quality

94%

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

92%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 highly actionable, well-sequenced scaffold workflow with an explicit validation gate and clean one-level-deep reference structure. Its only imperfection is minor over-inclusion (full license text, a few rationale sentences) that costs a few tokens without hurting clarity.

DimensionReasoningScore

Conciseness

The body is dense and imperative, explaining only project-specific conventions and justified deviations (e.g., why `upgrade` needs `--bump`) rather than concepts Claude already knows. Minor trimmable inclusions — the full inline MIT license text and a few rationale sentences like 'just --list is the discovery surface' — keep it at anchor 4 rather than 5.

4 / 5

Actionability

Guidance is copy-paste ready: a 9-step sequence with exact commands (`mise use --pin <tool>@latest`, `mise trust`, `mise fmt`, `git init -b main`), complete file templates (ci.yml with pinned action SHAs, .editorconfig, README, AGENTS.md), an exact commit subject, and full per-stack commands and manifests delegated to verified reference files. This matches anchor 5's 'fully executable; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The shared sequence is explicitly ordered with a hard validation gate in step 9 ('A red `just check` is a scaffold failure, not a caveat — fix it before telling the user the project is ready') and a pre-flight safety check ('Never scaffold over a non-empty directory without asking first'), plus a directed fix-before-done loop. Anchor 5's explicit validation and error-recovery feedback loop are both present.

5 / 5

Progressive Disclosure

SKILL.md is a clean overview: stack-independent steps, shared templates, and cross-stack conventions, with per-stack detail clearly signaled one level deep into references/<stack>.md ('read the matching file before step 2') and an external authority pointer to the justfile skill. All four referenced files exist and are substantive (~170–215 lines each), and the only cross-references between them (rust/go/typescript pointing at python.md for the shared justfile header) are lateral deduplication, not nested navigation.

5 / 5

Total

19

/

20

Passed

Description

92%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 with explicit 'Use when' triggers, a concrete multi-action 'what', and a well-delineated niche across four named stacks. The only weakness is modest synonym coverage for natural trigger phrases.

DimensionReasoningScore

Specificity

The description lists four concrete scaffold actions — "scaffolds mise-pinned tools, a just task surface, the standard repo files, and CI" — and names all four supported stacks with their package managers (uv, bun, cargo), giving comprehensive coverage of the skill's capabilities. It goes beyond anchor 4 ('several specific actions; minor gaps') because nothing material about the scaffold scope is left unspecified.

5 / 5

Completeness

Both halves are explicit: the 'what' is the enumerated scaffold output (mise-pinned tools, just task surface, repo files, CI) and the 'when' is a literal 'Use when' clause with two concrete triggers ($new-project invocation, creating a brand-new repository from scratch). This matches the anchor-5 example structure exactly; anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural triggers like "creating a brand-new repository or project from scratch", "invoked as $new-project", and the four stack names (Python, TypeScript, Rust, Go) match what users would say. It falls short of anchor 5 because common synonyms such as 'scaffold', 'bootstrap', 'initialize', or 'new repo' are absent.

4 / 5

Distinctiveness Conflict Risk

The from-scratch constraint, the explicit $new-project invocation name, and the mise/just toolchain scope carve out a clear niche that would not fire for existing-project skills (e.g., adding a justfile or Brewfile to a repo). Conflict risk with other skills is minimal.

5 / 5

Total

19

/

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

phatblat/dotfiles

Path

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