CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-discovery

Analyze course transcript files (.srt) to discover teachable projects. Use when you need to scan a course folder and identify what hands-on projects are taught, without generating any code. Outputs a manifest file that can be used later for selective project generation. Triggers on phrases like "discover projects", "analyze course", "find projects in transcripts", "what projects are in this course".

Quality

86%

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

68%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 strong, highly actionable workflow: concrete commands, exact JSON output formats, explicit analysis heuristics, and clear DO NOT boundaries, with detail correctly deferred to two real reference files. The main weaknesses are the absence of an output-validation checkpoint for this batch analysis and padding from a duplicated JSON example and a tech-stack taxonomy Claude already knows.

Suggestions

Add a validation checkpoint between Step 5 and Step 6: before reporting, verify every discovered .srt appears in either a project's source_srts or skipped_srts (and that counts reconcile), re-scanning if they don't.

Replace the second full 'no projects found' JSON example with a short note on which fields change (has_projects: false, projects: [], no_project_reason set) to remove the duplication.

Condense the Tech Stack Detection table to a single instruction to detect and record technologies in the manifest — the language/framework/database categorization is knowledge Claude already has.

DimensionReasoningScore

Conciseness

Mostly efficient, but the second full 'no projects found' JSON example re-lists ~10 fields already shown, and the Tech Stack Detection table ('Look for mentions of: Languages | JavaScript, TypeScript, Python, Java, Go, Rust') restates taxonomy Claude already knows; the full report template is also trimmable. This fits 'includes some unnecessary explanation or could be tightened' rather than the 4 anchor's 'minor instances of over-explanation'.

3 / 5

Actionability

Provides an executable command ('find . -name "*.srt" -type f | grep -v "CODE/" | sort'), exact progress.json and project-findings.json structures, concrete field tables, explicit start/continue/end/skip heuristics with example phrases, and a naming pattern ('Project_[Framework][CoreFeature][Distinguisher]'). Guidance is copy-paste ready and covers the common cases, matching the 5 anchor; there are no material gaps that would justify 4.

5 / 5

Workflow Clarity

The six steps are clearly sequenced with restart/idempotency handling ('Previous run was interrupted. Clean up any partial CODE/__CC_Projects/ folder and restart'), but there is no output validation — nothing verifies that every SRT file lands in either a project's source_srts or skipped_srts before reporting completion. Per the rubric guideline, a batch operation without validation/verification is capped at 3; it is not 2 because the sequence and steps are well defined, not 'poorly defined'.

3 / 5

Progressive Disclosure

The 'Reference Files' section clearly signals two one-level-deep references ('discovery-patterns.md - Detailed patterns for identifying projects', 'manifest-schema.md - Complete JSON schema for project-findings.json'), both of which exist in the bundle and contain the promised detail. However, the ~50-line inline manifest JSON example partially duplicates manifest-schema.md, a minor organization gap that keeps it below the 5 anchor's 'content appropriately split'; it is above 3 because the bulk of detailed material (patterns, full schema) is properly deferred to references.

4 / 5

Total

15

/

20

Passed

Description

96%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: concrete actions with the .srt extension, an explicit 'Use when' clause with natural trigger phrases, and a clear what/when boundary including the no-code constraint. The only weakness is the slightly broad 'analyze course' trigger, which carries minor overlap risk with unrelated course-analysis requests.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with the file type: 'Analyze course transcript files (.srt)', 'scan a course folder and identify what hands-on projects are taught', 'Outputs a manifest file', plus the explicit boundary 'without generating any code'. Coverage of the skill's capability surface is complete, matching the 5 anchor; it is not 4 because no meaningful actions are missing.

5 / 5

Completeness

Explicitly answers both questions: what ('Analyze course transcript files (.srt) to discover teachable projects... Outputs a manifest file') and when ('Use when you need to scan a course folder...', 'Triggers on phrases like...'). This matches the 5 anchor's 'clearly and explicitly answers both what AND when with concrete trigger phrases'; not 4 because the when-clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say: 'discover projects', 'analyze course', 'find projects in transcripts', 'what projects are in this course', plus the '.srt' file extension — covering synonyms, a question form, and an extension as in the 5 anchor. Not 4, since no common variations are conspicuously absent.

5 / 5

Distinctiveness Conflict Risk

The niche (course transcript project discovery producing a manifest, explicitly 'without generating any code') is clearly distinct from a companion generation skill, but the trigger 'analyze course' is broad enough that a user meaning some other course analysis could invoke it — fitting the 4 anchor's 'minor overlap risk'. Not 5 because that trigger does not guarantee minimal conflict risk; not 3 because the .srt/manifest domain is far more specific than generic 'works with document files'.

4 / 5

Total

19

/

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-discovery/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.