CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

before-dev

Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards.

Quality

87%

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

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

A lean, highly actionable instruction body: every step carries an exact command or concrete decision criterion, and the structure is well organized for a single-file skill. The only trims available are the redundant opening and closing sentences, and workflow clarity lacks an explicit confirmation checkpoint before proceeding — both minor.

DimensionReasoningScore

Conciseness

The ~34-line body is pure numbered instruction with no concept-teaching and fully assumes Claude's competence. It is not anchor 5 ("every token earns its place") because the opening "Read the relevant development guidelines before starting your task" and the closing "This step is mandatory before writing any code" are redundant bookends restating the description and step 1.

4 / 5

Actionability

Three copy-paste-ready commands with exact paths ("python3 ./.trellis/scripts/get_context.py --mode packages", "cat .trellis/spec/<package>/<layer>/index.md", "cat .trellis/spec/guides/index.md") plus explicit selection criteria with examples (backend, frontend, unit-test, docs) and named guideline files. Fully executable guidance covering the common cases — anchor 5.

5 / 5

Workflow Clarity

Steps 1–6 are clearly numbered and sequenced, with a checklist-driven decision point ("Follow the Pre-Development Checklist section") and an anti-failure guard ("The index is NOT the goal"). It falls short of anchor 5 because there is no explicit checkpoint confirming all relevant guideline files were read before proceeding to step 6 — a minor validation gap, not the missing-sequence or absent-validation issues of anchors 2–3.

4 / 5

Progressive Disclosure

Per the rubric's simple-skill note, a sub-50-line skill with no need for external references scores 5 with well-organized sections: the numbered bold-headed steps and sub-bullets are clear, and the skill correctly points to external project spec content rather than inlining it. No bundle files exist, so there is no nested-reference risk.

5 / 5

Total

18

/

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 that explicitly answers both what (discover/inject/read spec guidelines from .trellis/spec/) and when (four concrete "Use when" triggers) in third person. It is specific and largely distinct; the only weaknesses are a few missing natural trigger variants and broad timing phrases that create minor conflict risk with other dev-workflow skills.

DimensionReasoningScore

Specificity

"Discovers and injects project-specific coding guidelines from .trellis/spec/" and "Reads spec indexes, pre-development checklists, and shared thinking guides" list several concrete actions anchored to a specific path. This matches anchor 4 (several specific actions, minor gaps) rather than 5, because it never states how the discovered guidelines are applied, leaving slight coverage gaps.

4 / 5

Completeness

The what is explicit ("Discovers and injects... Reads spec indexes, pre-development checklists, and shared thinking guides") and the when is an explicit "Use when..." clause with four concrete trigger phrases. This matches anchor 5 exactly; anchor 4's "when could be more explicit" does not apply since multiple concrete triggers are enumerated.

5 / 5

Trigger Term Quality

Triggers "starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards" are natural phrases users would say, supplemented by the ".trellis/spec/" path. Good coverage but not anchor 5's comprehensive synonym/extension list — standalone terms like "trellis" or "read the specs" are absent.

4 / 5

Distinctiveness Conflict Risk

The ".trellis/spec/" niche and spec-reading workflow are clearly distinct, but broad timing triggers like "before writing any code" and "starting a new coding task" could overlap with general development-workflow skills. Mostly distinct with minor overlap risk (anchor 4), not anchor 5's minimal-conflict clear niche.

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

202780181/lingxiData

Path

.agents/skills/before-dev/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.