CtrlK
BlogDocsLog inGet started
Tessl Logo

reports

Save and load timestamped reports. Keyword routing for fast lookup. Cron jobs save output as reports; the agent or user queries them by keyword. Includes the Actionability Gate: delivery-time link checks (Broken/Dead/Indirect/ Missing) for briefings, meeting digests, and research reports.

64

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

Quality

Content

85%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 highly actionable, well-sequenced instruction skill: concrete templates, executable checks, and a genuine validate-retry feedback loop for delivery gating. The weaknesses are modest — some redundancy between the two link tables and a monolithic single-file layout where the Actionability Gate detail could be split into a reference file.

Suggestions

Merge the 'Blocked vs warning' table into the 'Four failure modes' table (or drop one) to remove the repeated Broken/Dead/Indirect/Missing content and tighten conciseness.

Move the Actionability Gate detail (failure taxonomy, pattern tables, retry loop, prompt snippet) into a references/ file and keep a short gate summary in SKILL.md, enabling progressive disclosure as the skill grows.

Specify how 'Load latest' resolves the most recent file (e.g. sort by timestamped filename or list the category directory) and how custom keyword mappings are configured.

DimensionReasoningScore

Conciseness

The body is dense and operational — file path templates, two tight tables, a numbered retry loop — with no explanation of concepts Claude already knows. It is not a 5 because the 'Blocked vs warning' table substantially repeats the 'Four failure modes' table, and lines like 'A missing link is honest. An indirect link is a broken promise' are rhetorical padding. It is well above anchor 3, which requires unnecessary explanation.

4 / 5

Actionability

Guidance is fully concrete: the save path pattern 'reports/{category}/{YYYY-MM-DD-HHMM}.md' with a complete frontmatter template, executable checks ('run git status in the brain repo', 'gbrain get <slug>'), specific blocked URL patterns, and a copy-paste-ready LLM-prompt gate snippet. This is an instruction-only skill and the guidance is executable throughout.

5 / 5

Workflow Clarity

The Phases section sequences save/load/routing, and the retry loop is an explicit validate→fix→re-check feedback loop with a bounded retry count ('Max 2 retries') and a clear delivery rule ('Broken, Dead, and Indirect links never ship'). Validation checkpoints are explicit rather than merely present, matching the anchor-5 example's structure.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ do not exist) and the entire skill is ~120 inline lines; the Actionability Gate section (~60 lines of taxonomy, tables, and retry loop) is a natural candidate for a separate reference file. The external pointers ('skills/_output-rules.md', 'skills/briefing/SKILL.md') lie outside the bundle. The skill exceeds the under-50-line simple-skill exception, so well-organized sections alone do not justify a higher score.

3 / 5

Total

17

/

20

Passed

Description

71%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 specific, third-person description that clearly states what the skill does, with concrete capability coverage and mostly natural trigger terms. Its main weakness is the absence of an explicit 'Use when...' clause, leaving the invocation conditions implied rather than stated.

Suggestions

Add an explicit 'Use when...' sentence, e.g. 'Use when the user asks to save, load, or look up the latest report, or before delivering a briefing, meeting digest, or research report with links.'

Include the natural query phrasings users would actually say ('latest report', 'show me the briefing', 'report quality') in the description text itself, not only the triggers list.

Name the report categories or example queries ('morning briefing', 'meeting digest') so the routing capability is discoverable from the description alone.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Save and load timestamped reports', 'Keyword routing for fast lookup', 'Cron jobs save output as reports; the agent or user queries them by keyword', and 'delivery-time link checks (Broken/Dead/Indirect/Missing)' — giving comprehensive coverage of the skill's capabilities. It is not a 4 because the gaps in coverage (save, load, routing, gating) are essentially none.

5 / 5

Completeness

The 'what' is clear and specific, but there is no 'Use when...' clause or equivalent; the 'when' is only weakly implied by 'Cron jobs save output as reports; the agent or user queries them by keyword'. Per the judging guidelines, a missing explicit 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms are present ('reports', 'briefings', 'meeting digests', 'research reports', 'cron jobs', 'link checks'), but common variations a user would actually say — e.g. 'latest report', 'show me the report', 'pull up the briefing' — are missing from the description itself. Good coverage, not comprehensive, so it sits between anchors 4 and 5 but clearly closer to 4.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a fairly distinct niche (timestamped report persistence plus the Actionability Gate link taxonomy), which is unlikely to be confused with unrelated skills. Minor overlap risk remains with generic report-writing or briefing-generation skills, keeping it below 5.

4 / 5

Total

16

/

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
garrytan/gbrain
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.