CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-generator

Generate complete, working code projects from course transcript analysis. Use when you have a project specification (from discovery or manual input) and need to create all implementation files, documentation, and configuration. Triggers on phrases like "generate project", "create project from transcript", "build the project", "generate Project_XxxYyy".

Quality

78%

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 ./skills/__backup/project-generator/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.

The body delivers a well-sequenced, highly actionable 9-step workflow with concrete templates, config examples, and thoughtful error handling. Its main weaknesses are duplication — full templates and per-stack structures are inlined in SKILL.md even though equivalent references exist — and the absence of a post-generation verification step. Restructuring around the existing reference files would improve both conciseness and progressive disclosure.

Suggestions

Replace the inline CLAUDE.md/README.md/USAGE.md/CHANGELOG.md templates in Step 4 with a short summary plus a pointer to references/file-templates.md, which already contains the complete templates — this removes ~100 duplicated lines.

Move the per-tech-stack directory trees ('Generation Guidelines by Tech Stack') into references/code-patterns.md and reference them from Step 3/Step 6 instead of duplicating them inline.

Add an explicit verification checkpoint after Step 6 (e.g., run `npm install` and the build/dev command in the generated project and fix any errors before updating the manifest), which would close the workflow validation gap for a skill that mandates working code.

DimensionReasoningScore

Conciseness

The 458-line body is mostly concrete, but it inlines complete CLAUDE.md/README.md/USAGE.md/CHANGELOG.md templates that duplicate references/file-templates.md ("Complete templates for all required documentation files"), and includes generic advice Claude already knows ("Meaningful variable/function names", "Consistent formatting", "Comments only for complex logic"). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is mostly executable: exact output paths (CODE/__CC_Projects/{synthesized_name}/), concrete JSON shapes for manifest/progress updates, copy-ready config files (tsconfig.json, vite.config.js, requirements.txt), and a worked report example. Minor gaps keep it from 5: the package.json example contains placeholder comments ("// Real dependencies with actual versions") and the Step 2 readFile loop is illustrative pseudocode.

4 / 5

Workflow Clarity

A clear 9-step sequence with most checkpoints present: validating source SRTs exist, the append-only CHANGELOG check-before-write procedure, and an error-handling section covering partial and complete failure with cleanup and status reporting. Not 5 because there is no post-generation verification that the emitted code actually installs/builds/runs — a notable gap for a skill whose CRITICAL REQUIREMENT is "WORKING CODE ONLY"; not 3 because checkpoints are explicit rather than missing or implicit.

4 / 5

Progressive Disclosure

Both referenced files (references/file-templates.md, references/code-patterns.md) exist, are one level deep, and are listed in a 'Reference Files' section — but that section sits at the very end and the body duplicates their content instead of delegating to them (full doc templates inline; per-stack directory trees that overlap code-patterns.md). This matches 'references present but not clearly signaled; content that should be separate is inline' rather than 4, where content would be appropriately split.

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 that clearly states what the skill does and when to use it, with an explicit 'Use when...' clause and natural trigger phrases. Third-person voice is used correctly and there is no fluff. Minor improvement is possible by adding a few more trigger synonyms and reflecting the manifest-update side effects.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Generate complete, working code projects from course transcript analysis" and "create all implementation files, documentation, and configuration" — which matches the 'several specific actions; minor gaps' anchor. It falls short of 5 because it omits capabilities the skill actually performs (manifest updates, per-tech-stack scaffolding), and sits above 3 because the actions are multiple and specific rather than 1-2.

4 / 5

Completeness

It explicitly answers both questions: what ("Generate complete, working code projects... create all implementation files, documentation, and configuration") and when ("Use when you have a project specification (from discovery or manual input)" plus concrete trigger phrases). This matches the top anchor's pattern of what + explicit when with concrete triggers.

5 / 5

Trigger Term Quality

It quotes natural trigger phrases users would say — "generate project", "create project from transcript", "build the project", "generate Project_XxxYyy" — giving good keyword coverage. Not 5 because common synonyms like "scaffold", "implement", or "set up the project" are missing; not 3 because the listed phrases are natural user phrasing rather than just domain keywords.

4 / 5

Distinctiveness Conflict Risk

The course-transcript-to-project niche with transcript-specific triggers ("create project from transcript", "generate Project_XxxYyy") is mostly distinct. Not 5 because "generate project" / "build the project" could overlap with generic code-generation or scaffolding skills; not 3 because the transcript framing strongly disambiguates.

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

KennethJefferson/cc_App_ProjectSynthesizer

Path

skills/__backup/project-generator/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.