CtrlK
BlogDocsLog inGet started
Tessl Logo

project-development

This skill should be used for project-level decisions about LLM-powered systems: whether an LLM is the right primitive for the task at hand, the shape of a multi-stage batch or agent pipeline, token and cost estimation, choosing between single-agent and multi-agent at the project level, structured output design for downstream parsing, and structuring agent-assisted iteration. Use this when the unit of work is a whole project or a multi-stage pipeline. Route individual tool design to tool-design and individual skill-loading or context-budget tactics to context-optimization.

62

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/project-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured methodology document with genuinely concrete artifacts (fit tables, cost formula, file-system state machine, ordered planning template with validation). Its main weaknesses are repetition — routing and unit-of-work framing each appear three times — and the orphaned scripts/pipeline_template.py bundle file that the body never mentions, which both hurts navigation and wastes its executable value.

Suggestions

Reference scripts/pipeline_template.py from the body (e.g., in 'Pipeline Architecture' or 'Project Planning Template': 'Use the staged template: python scripts/pipeline_template.py acquire --batch-id <id>') so the main executable asset in the bundle is discoverable.

Deduplicate the sibling-skill routing: state it once in 'When to Activate' or 'Integration' and cut the other two occurrences, and remove the duplicated Vercel d0 example from 'Examples' in favor of a pointer to the Case Studies reference.

Tighten conciseness by converting the repeated unit-of-work framing to a single statement and moving the 'Skill Metadata' version/date block out of the always-loaded body (or removing it), keeping time-sensitive details in a reference file.

DimensionReasoningScore

Conciseness

The body is dense and rationale-driven with no padding of concepts Claude already knows, but routing to sibling skills is stated three times (intro paragraph, 'When to Activate' do-not list, 'Integration' section), the unit-of-work claim is repeated three times, the Vercel d0 example appears in both 'Architectural Reduction' and 'Examples', and a 'Skill Metadata' section carries time-sensitive version dates. This is noticeably repetitive rather than just minor trims (score 4) but far from the heavy padding of score 2.

3 / 5

Actionability

Concrete guidance throughout: a cost formula ('Total cost = (items x tokens_per_item x price_per_token) + API overhead'), the canonical 'acquire -> prepare -> process -> parse -> render' structure, an explicit file-system state layout, proceed/stop fit tables, and a 5-step planning template. It is not score 5 because the fully executable scripts/pipeline_template.py is never linked and template steps remain directive rather than runnable, leaving minor gaps.

4 / 5

Workflow Clarity

'Follow this template in order, because each step validates assumptions before the next step invests effort' plus per-step validation (manual validation as step 2, 'Implement stage-by-stage, testing each before proceeding', 'run evaluation checks before and after every model or prompt change') gives a clear sequence with most checkpoints present — the batch-operation validation cap does not apply since verification is explicit. It is not score 5 because there is no explicit validate→fix→re-validate loop at the command level.

4 / 5

Progressive Disclosure

Section structure is good and the two reference files are well-signaled with 'Read when' conditions ('[Case Studies](./references/case-studies.md)... Read when: evaluating architecture tradeoffs'), but scored against the actual bundle: scripts/pipeline_template.py — the main executable asset — is referenced nowhere in the body and is undiscoverable, and the 'Examples' section duplicates case-study material that lives in references/. An orphaned executable script is more than a minor organization gap, ruling out score 4; the references that are present are clearly signaled, which is better than score 2's inlined-monolith anchor — so score 3 is the best fit.

3 / 5

Total

14

/

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: it lists concrete capabilities, gives an explicit use-when clause, and actively disambiguates against sibling skills with routing guidance. The main residual weakness is that the when-clause is framed at the meta level ('unit of work') rather than as concrete trigger phrases a user would naturally say.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'whether an LLM is the right primitive for the task at hand', 'the shape of a multi-stage batch or agent pipeline', 'token and cost estimation', 'choosing between single-agent and multi-agent at the project level', 'structured output design for downstream parsing' — giving comprehensive coverage of the skill's actions. This matches the anchor for multiple specific concrete actions; it is not score 4 because no meaningful capability gaps remain.

5 / 5

Completeness

Both parts are explicit: the 'what' is the enumerated capability list, and the 'when' is stated as 'Use this when the unit of work is a whole project or a multi-stage pipeline'. It is not score 3 because the when-clause is explicit rather than weakly implied; it is not score 5 because the trigger is meta-level ('the unit of work is') rather than concrete user-mentionable trigger phrases like 'when the user mentions PDFs, forms, or document extraction'.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms like 'multi-stage batch or agent pipeline', 'token and cost estimation', 'multi-agent', and 'structured output'. It falls between anchors 3 and 4 (noticeably above the midpoint): coverage is good but common variations users might say ('batch processing', 'agent architecture', 'budget', 'RAG pipeline') are missing, so not score 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (project-level and pipeline-shape decisions) is reinforced by explicit de-routing: 'Route individual tool design to tool-design and individual skill-loading or context-budget tactics to context-optimization.' Distinct triggers and explicit boundaries to adjacent skills keep conflict risk minimal, matching the anchor 5 example; voice is third-person/passive-imperative so no voice penalty applies.

5 / 5

Total

18

/

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
muratcankoylan/Agent-Skills-for-Context-Engineering
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.