CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

summary-generator

Generate structured documentation and summaries from validated course files. Creates comprehensive study guides, topic overviews, and reference documentation. Input is path to __cc_validated_files/ folder. Output is markdown documentation in __ccg_Summary/ folder.

Quality

72%

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/summary-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 is a compact, highly actionable operator's manual: copy-paste-ready commands, a complete CLI reference, and a clear output contract, with a real backing script in the bundle. Its main weakness is the absence of any validation or verification checkpoint for what is a batch generation operation over many input files.

Suggestions

Add a verification step after generation, e.g., 'Run with -j/--json and check the reported topic count and skipped files before considering the summary complete', to satisfy the batch-operation validation requirement.

Document failure behavior: what happens when the input folder is empty, files are unreadable, or no topics meet the --min-content threshold.

Consolidate the duplicated options between Quick Start and CLI Reference to tighten token usage.

DimensionReasoningScore

Conciseness

The body is efficient with no explanations of concepts Claude already knows — Quick Start commands, an output tree, format bullets, and a CLI reference. It is not a 5 because the CLI Reference partially duplicates the flags already shown in Quick Start (-o, --format, --toc) and the 'Content Analysis' internals section could be trimmed.

4 / 5

Actionability

Quick Start provides four copy-paste-ready commands covering the common cases, the CLI Reference documents every argument and option with defaults, and Integration gives a concrete invocation command ('ccke -i ./courses -ccg Summary'). The referenced script scripts/summary_generate.py exists in the bundle, making everything fully executable.

5 / 5

Workflow Clarity

The single action (run summary_generate.py on a validated folder) is unambiguous, but the script batch-processes every file in the input directory into up to 20 topic files with no validation or verification step described — no failure handling, output checking, or use of the -j/--json results flag as a checkpoint. The rubric's cap for batch operations without validation limits this to 3, overriding the simple-skill exception.

3 / 5

Progressive Disclosure

Sections are well organized (Quick Start, Output Structure, Formats, CLI Reference, Integration), the referenced script path is a real bundle file, and nothing is inlined that belongs in a separate reference file. Not 5 because the body exceeds the under-50-lines threshold where well-organized sections alone suffice, leaving minor organization gaps (CLI option duplication could be consolidated).

4 / 5

Total

16

/

20

Passed

Description

53%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 answers 'what' clearly with a precise input/output contract and a distinct niche, but it completely lacks any 'when to use' trigger guidance and its keywords have no synonyms or variations. All actions collapse into one generic 'generate documentation' operation with output-type variations.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user wants study guides, summaries, or reference docs generated from a validated course folder, or mentions __cc_validated_files/ or __ccg_Summary/.'

Broaden natural trigger vocabulary with synonyms users would actually say, such as 'course notes', 'review material', 'cheat sheet', or 'summarize the course'.

Replace generic wording ('Generate structured documentation', 'comprehensive') with the distinct operations the skill actually performs (e.g., 'extracts topics, builds a glossary, and compiles a quick-reference guide').

DimensionReasoningScore

Specificity

Names the domain ('validated course files') and lists deliverables ('comprehensive study guides, topic overviews, and reference documentation'), but these are output-type variations of the single generic action 'generate documentation' rather than several distinct concrete operations, and 'comprehensive' is mild fluff. It sits below anchor 4, whose examples show multiple distinct actions like 'extracts text, fills forms, converts pages to images'.

3 / 5

Completeness

The 'what' is clear and precise (deliverables plus explicit input path __cc_validated_files/ and output folder __ccg_Summary/), but there is no 'when' at all — no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the when-clause is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Includes some natural user terms ('summaries', 'study guides', 'documentation', 'course files') but misses common variations and synonyms (e.g., notes, review material, cheat sheet, course content) and includes no file extensions or trigger framing. This matches 'some relevant keywords but missing common variations or synonyms' rather than the good coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

The explicit __cc_validated_files/ input and __ccg_Summary/ output contract pin the skill to a distinct pipeline niche, making it mostly distinguishable from generic summarization/documentation skills. Not 5 because terms like 'summaries' and 'documentation' are broad enough to create minor overlap with other summary or documentation skills.

4 / 5

Total

13

/

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_sdk_knowledge_extractor

Path

skills/summary-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.