CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-development

This skill covers the principles for identifying tasks suited to LLM processing, designing effective project architectures, and iterating rapidly using agent-assisted development.

Quality

64%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/project-development/SKILL.md

The canonical home for this skill is project-development in administrakt0r/AI-Agents-Safe-Coding-Skills

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.

The body delivers genuinely useful, opinionated methodology with concrete artifacts (pipeline structure, file layout, prompt template, cost formula) and a well-sequenced planning workflow. Its weaknesses are repetition and known-concept padding that inflate token cost, and dead references to nonexistent bundle files ("Case Studies", "Pipeline Patterns") that break progressive disclosure.

Suggestions

Create the referenced bundle files (e.g., references/case-studies.md, references/pipeline-patterns.md) or remove the "See Case Studies" / "Internal references" pointers and the inlined Examples section they duplicate — currently they point to nothing.

Cut redundant/padding content: merge "The Manual Prototype Step" into "Task-Model Fit Recognition", trim the "Agent-Assisted Development" basics Claude already knows, and drop the "Skill Metadata" block.

Split the Detailed Topics and Examples sections into one-level-deep reference files with clear links (e.g., "**Case studies**: See [case-studies.md](references/case-studies.md)") to slim the main SKILL.md toward an overview.

DimensionReasoningScore

Conciseness

The core methodology (pipeline stages, file-system state machine, cost formula) is non-obvious and earns its place, but "The Manual Prototype Step" largely repeats "Task-Model Fit Recognition", "Agent-Assisted Development" spells out basics Claude already knows ("generate, test, fix, repeat"), and the "Skill Metadata" block (Created/Last Updated/Author/Version) is pure padding — matching anchor 3's 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

For an instruction-only skill the guidance is mostly concrete and directly usable: the canonical pipeline ("acquire → prepare → process → parse → render"), an exact file layout (data/{id}/raw.json …), a copy-adaptable structured-output prompt template, a cost formula, and a 5-step planning template. It falls short of anchor 5 because there is no executable code and several directives remain advisory ("Build robust parsers that handle variations").

4 / 5

Workflow Clarity

The Project Planning Template is a clearly sequenced 5-step process with an explicit validation checkpoint ("If the manual prototype fails, the automated system will fail") and recovery guidance ("To re-run a stage: delete its output file and downstream files"), fitting anchor 4's 'clear sequence with most checkpoints present'. It is not anchor 5 because validate→fix→retry feedback loops for the batch operations the skill teaches are only implicitly described (log-and-review parsing failures) rather than explicit.

4 / 5

Progressive Disclosure

The body is well-sectioned, but it references bundle documents that do not exist in the bundle ("See Case Studies for detailed analysis", "Internal references: Case Studies… Pipeline Patterns") with no paths or links, and content that clearly belongs in separate files (the detailed Examples/Case Studies material) is inlined — matching anchor 3's 'references present but not clearly signaled; content that should be separate is inline'. It is above anchor 2 because the document itself has clear, navigable section structure.

3 / 5

Total

14

/

20

Passed

Description

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

The description clearly states what the skill covers, but reads as a syllabus-style capability list rather than a triggerable skill description: it lacks any 'Use when...' clause, its action areas are thematic rather than concrete, and it misses the natural trigger phrases users would say when needing this skill. These gaps leave it at the midpoint across all dimensions.

Suggestions

Add an explicit trigger clause, e.g., "Use when starting an LLM-powered project, deciding whether a task should use agents vs traditional code, designing a batch processing pipeline, or estimating costs for LLM-heavy work."

Replace thematic phrases like "covers the principles for" with concrete actions users can map to their request, e.g., "Evaluates task-model fit, designs staged pipelines with file-system state, and writes parseable structured-output prompts."

Include natural keyword variants users would say ("LLM project", "agent pipeline", "batch processing", "should I use an agent") to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

Names the domain and three action areas ("identifying tasks suited to LLM processing", "designing effective project architectures", "iterating rapidly using agent-assisted development"), but these are thematic capabilities rather than the concrete operations of anchor 4 (e.g., "extracts text, fills forms, converts pages"), and coverage is not comprehensive.

3 / 5

Completeness

The 'what' is clearly stated (three capability areas), but there is no "Use when..." clause or any equivalent explicit trigger guidance; the rubric explicitly caps completeness at 3 in that case, so anchor 4 is unreachable.

3 / 5

Trigger Term Quality

Contains relevant keywords like "LLM processing", "agent-assisted development", and "project architectures", but misses the natural phrases a user would actually say (e.g., "start an LLM project", "should I use agents for this", "batch pipeline"), matching anchor 3's 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

It is scoped to LLM/agent project work, which is distinct from unrelated skills, but "project architectures" and "development" are broad enough to overlap with closely related skills in its own collection (tool-design, multi-agent-patterns, context-fundamentals), fitting anchor 3's 'somewhat specific but could still overlap with similar skills'.

3 / 5

Total

12

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/project-development/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.