CtrlK
BlogDocsLog inGet started
Tessl Logo

new-feat

Use when starting a piece of feature or fix work in this repository — taking or opening its GitHub issue, cutting the branch (a worktree on the local bare repo, an in-place branch on the remote environment) and producing the implementation plan, including the wiki pages the work will make stale and its observability plan. Also the step for turning a tracker finding into a branch without publishing it.

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

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.

An exemplary workflow skill: steps are strictly ordered and gated, commands are copy-paste ready, fallbacks for missing capabilities are defined up front, and detail is delegated to a real one-level-deep reference file. The only trimmable fat is a few extended rationale passages, and a couple of rule lists (observability naming, issue body) could be extracted to reference files.

Suggestions

Move the observability naming and span/metric rules to a reference file (e.g. references/observability.md, or lean harder on wiki/observability/overview.md) and keep only the one-line requirement in the plan checklist — the current inline list is the densest block in the body.

Tighten the two longest rationale passages (the complexity-contamination explanation in Step 0 and the NEW-FEAT.md compaction paragraph) to their operative rules; the reasoning is persuasive but the commands and constraints are what the executor needs.

Consider extracting the issue-body template and label/type rules to a reference so Step 0 reads as compactly as Step 1.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout — no basic-concept explanations — and nearly every sentence carries project-specific constraints ('a wrong config value produces a tidy diff, a green build and no behaviour change, which no gate can fail on'). A few rationale passages run long (the complexity-rating justification, the NEW-FEAT.md blackboard paragraph) and could be trimmed, which is the 4 anchor's 'minor instances of over-explanation' rather than the uniformly lean 5.

4 / 5

Actionability

Fully executable throughout: the pre-flight capability probe, 'gh issue create' with a complete body heredoc, both the worktree and in-place branch recipes with exact commands including the 'git config branch.<branch>.gh-merge-base' trick for stacked PRs — copy-paste ready with placeholders only where user input is genuinely required, matching the 5 anchor.

5 / 5

Workflow Clarity

'Four things, in this order — each depends on the one before' plus Steps 0–4 gives an explicit sequence; validation is equally explicit — the capability probe runs 'once, before Step 0' rather than failing per step, the 'When a gate cannot run' section defines fallback and honesty rules, and stress-plan is a hard gate ('every finding closed, before a line of code is written'). This is the 5 anchor's clear sequence with explicit validation and error-recovery, not 4's 'minor validation gaps'.

5 / 5

Progressive Disclosure

The body is a well-organized overview that delegates cleanly: 'The routing table is references/skills-routing.md' points to a real one-level-deep bundle file, and detailed material (rate-complexity, stress-plan, prep-pr, wiki/observability/overview.md) is referenced rather than inlined. Minor gaps keep it at 4 — the observability naming rules and issue-body conventions are long enough to live in a reference file, and skills-routing.md is the only bundle file carrying that load.

4 / 5

Total

18

/

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.

A strong description: it pairs an explicit 'Use when' trigger with a concrete, ordered action list covering the issue, branch and plan, and it carves out a distinct start-of-work niche. Its main weaknesses are jargon-heavy phrasing that crowds out natural user vocabulary and minor overlap with the closely related prep-pr skill.

Suggestions

Add natural synonyms a user would actually say — e.g. 'new feature', 'start work on', 'bugfix' — to broaden trigger coverage beyond project jargon like 'bare repo' and 'tracker finding'.

Sharpen the boundary with the sibling end-of-work skill by naming the counterpart, e.g. '...producing the implementation plan; use prep-pr once the work is done' — this both distinguishes the skills and signals the hand-off.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'taking or opening its GitHub issue, cutting the branch (a worktree on the local bare repo, an in-place branch on the remote environment) and producing the implementation plan, including the wiki pages the work will make stale and its observability plan' — comprehensive coverage of the workflow, matching the 5 anchor rather than 4 (no meaningful coverage gaps).

5 / 5

Completeness

It explicitly answers both questions: 'Use when starting a piece of feature or fix work in this repository' is a concrete trigger phrase, and the what follows immediately with the full action list — the exact shape of the 5 anchor, not merely the both-present-but-could-be-sharper 4 anchor.

5 / 5

Trigger Term Quality

Natural phrases like 'feature or fix work', 'GitHub issue', 'cutting the branch' and 'implementation plan' give good keyword coverage, but project-specific jargon ('bare repo', 'tracker finding', 'observability plan') dominates and common synonyms ('new feature', 'start work', 'bugfix') are absent — noticeably above the midpoint but short of the comprehensive-synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

A clear start-of-work niche with distinct triggers ('starting a piece of feature or fix work', 'turning a tracker finding into a branch without publishing it'), but the sibling end-of-work skill prep-pr covers the other half of the same pipeline, creating the minor overlap with a closely related skill that defines the 4 anchor rather than 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
englishstventures/osn
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.