CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

node-journal

Node journal (octobot.community.node_journal): record-only from outside the package; reads only for export inside node_journal; not a source of truth. Apply when editing node_journal or adding/changing record_* calls elsewhere.

Quality

91%

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

92%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 lean, well-structured boundary-conventions skill: every line is a specific rule, organization mirrors the two usage contexts, and detail is appropriately deferred one level deep. The only gap is that 'Tier-1' and an example record_* call are left to the referenced files.

DimensionReasoningScore

Conciseness

The ~25-line body is pure directive — the Purpose section is two sentences ('Append-only event log for diagnostics, journey analytics, and export/sharing (upload envelope). Not authoritative application state.') and every bullet is an actionable rule with zero concept explanations or padding. Every token earns its place.

5 / 5

Actionability

Guidance names concrete functions (record_*, record, read_events, build_journey_summary, build_upload_envelope), concrete files (events.py, constants.py, enums.py, __init__.py), and the exact import path, so it is mostly executable. Minor gaps keep it below 5: 'Tier-1' is undefined in-document (deferred to __init__.py) and there is no example record_* call.

4 / 5

Workflow Clarity

This is a single-purpose boundary skill under 50 lines whose core directive is an unambiguous two-branch rule (outside node_journal/ -> record only; inside -> reads only for the export pipeline). No destructive or batch operations are involved, so the validation cap does not apply and the simple-skill exception holds.

5 / 5

Progressive Disclosure

The skill is a single well-organized file (Purpose / Integrators / Inside / Related) with full rules one level deep in AGENTS.md, clearly signaled, and clearly labeled pointers to the specific module files. Nothing that belongs in a separate file is inlined, and at this size no bundle files are needed.

5 / 5

Total

19

/

20

Passed

Description

87%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 tight, third-person description that states concrete boundary rules and an explicit, specific trigger clause. Its only weaknesses are minor: a few natural synonyms are missing and capability coverage is not exhaustive.

DimensionReasoningScore

Specificity

The description lists several concrete, scoped rules ('record-only from outside the package', 'reads only for export inside node_journal', 'not a source of truth') with no vague language, naming the actual API surface (record_*). It falls short of 5 because coverage is not comprehensive — e.g., what the journal contains or where event literals live is absent.

4 / 5

Completeness

It explicitly answers both 'what' (record-only outside; reads only for export inside; not a source of truth) and 'when' ('Apply when editing node_journal or adding/changing record_* calls elsewhere') with concrete trigger phrases, matching the anchor-5 pattern rather than the anchor-4 case where the 'when' is less specific.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'editing node_journal', 'adding/changing record_* calls', and the full package path would match how a user references this work. A few natural synonyms ('event log', 'journal', 'logging') are missing, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

Triggers are scoped to one package path (octobot.community.node_journal) and one API prefix (record_*), giving it a clear niche with minimal conflict risk against other skills.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 7 suspicious

Warning

Total

15

/

16

Passed

Repository

Drakkar-Software/OctoBot

Path

.cursor/skills/node-journal/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.