CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

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

75%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 well-structured body with genuinely useful tables, concrete templates, and a strong validate-fix-retry feedback loop for link quality. The main weaknesses are minor: the load-latest phase lacks an executable command, the save phase omits write verification, and the lengthy Actionability Gate could be offloaded to a reference file.

Suggestions

Specify how 'Load latest' is executed (e.g. the exact `gbrain search` or file-listing command and how recency is determined) so every phase is copy-paste actionable.

Move the Actionability Gate details (failure-mode tables, gate snippet) to a reference file and keep a short gate summary in SKILL.md to improve progressive disclosure.

Tighten the 'Consumers' paragraph by dropping the 'harness-routing convention' parenthetical or making the routing rule concrete.

DimensionReasoningScore

Conciseness

Mostly lean: the failure-mode and blocked/warning tables are dense and every row carries a rule; no space is spent explaining concepts Claude already knows. Not a 5: minor trimmable parts remain — the vague 'Consumers' paragraph with its 'harness-routing convention' parenthetical, and rhetorical flourishes like "A missing link is honest. An indirect link is a broken promise."

4 / 5

Actionability

Concrete and executable in most places: exact path template `reports/{category}/{YYYY-MM-DD-HHMM}.md`, a full frontmatter block, keyword mappings, a paste-able LLM gate snippet, and specific error handling (`write_pending`, exit 10, `gbrain write-request <request_id>`). Not a 5: "Load latest. Given a category, find the most recent report file" gives no command or mechanism, and the save phase doesn't state the write command.

4 / 5

Workflow Clarity

The Actionability Gate retry loop is exemplary — compose, scan every link (with `git status` and `gbrain get <slug>` as explicit checkpoints), fix, re-check, capped at 2 retries — which is a true validate-fix-retry feedback loop. Not a 5: the save/load phases have validation gaps (no post-write verification in the phase list, and the load step is underspecified), so it sits between anchors 4 and 5.

4 / 5

Progressive Disclosure

Well-organized sections (Contract, Phases, Actionability Gate, When it fails, Anti-Patterns) with clearly signaled one-level references to external docs (`../conventions/agent-operator-protocol.md`, `skills/briefing/SKILL.md`); no bundle files exist to verify beyond the body. Not a 5: the ~70-line Actionability Gate section is a candidate for a separate reference file, which would keep SKILL.md a leaner overview.

4 / 5

Total

16

/

20

Passed

Description

75%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 solid, concrete description in consistent third-person voice: it states what the skill does, who uses it (cron jobs, agent, user), and names a distinctive link-quality taxonomy. Its main gaps are the absence of an explicit "Use when..." trigger clause and incomplete coverage of capabilities (search is undocumented in the description).

Suggestions

Add an explicit 'Use when...' clause (e.g. 'Use when a cron job needs to save output as a report or the user asks for the latest briefing or report by keyword') to lift completeness to the top anchor.

Mention the search capability ('searchable via gbrain search') in the description so capability coverage is comprehensive.

DimensionReasoningScore

Specificity

Names several concrete actions — "Save and load timestamped reports", "Keyword routing for fast lookup", "delivery-time link checks (Broken/Dead/Indirect/Missing)" — with a specific failure taxonomy. Not a 5: coverage has gaps, e.g. the search/query capability only appears in the body, not the description.

4 / 5

Completeness

The "what" is clear (save/load timestamped reports with keyword routing and link checks), and the "when" is stated explicitly via "Cron jobs save output as reports; the agent or user queries them by keyword" plus the consumers named (briefings, digests, research reports). Not a 5 because there is no explicit "Use when..." clause and the trigger guidance could be more specific.

4 / 5

Trigger Term Quality

Includes natural phrases users would say — "briefings", "meeting digests", "research reports", "save and load ... reports" — alongside the more technical "Actionability Gate". Not a 5: common variations and synonyms (e.g. "latest report", "show me the briefing") appear only in the triggers list, not the description itself.

4 / 5

Distinctiveness Conflict Risk

The timestamped-report format, keyword routing, and named Actionability Gate taxonomy give it a distinct identity unlikely to collide with unrelated skills. Not a 5: "save and load reports" is a fairly common capability shape, leaving minor overlap risk with generic note/save skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

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