observability-logging

Logs sessions, tracks activity, records delegation decisions, and stores review/dispute outcomes as NDJSON audit trails. Use when logging session activity, tracking work, recording decisions, building audit trails, capturing delegation history, or running pre-response verification checklists. Trigger terms: log, track activity, audit trail, session record, delegation log, NDJSON

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%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 highly actionable, with complete executable commands for all five event types and a validation-backed checklist that sequences the logging workflow. It is slightly over-emphasized in its gate/stop language and relies on an external README for schema detail rather than bundled references.

Suggestions

Collapse the redundant 'HARD GATE' callout, 'STOP. Verify' box, and checklist's 'session record (ALWAYS)' line into a single concise enforcement statement to reduce token padding.

Inline a minimal field/schema summary (or add a bundled references/SCHEMA.md) so the full schema is one level deep inside the bundle instead of only in the external .opencastle/logs/README.md.

Consolidate the per-event, never-batch logging rule (currently implied across the table and prose) into one explicit statement to tighten the workflow.

Dimension	Reasoning	Score
Conciseness	Mostly lean with executable commands and a compact table, but the repeated 'HARD GATE' / 'STOP. Verify before responding' emphasis and duplicated 'session record (ALWAYS)' messaging across the gate, examples, and checklist add minor padding that could be trimmed, fitting the 4-anchor rather than 5.	4 / 5
Actionability	Five copy-paste-ready `opencastle log` commands cover every event type (session, delegation, review, panel, dispute) with full flags, plus a verify command — matching the 5-anchor for fully executable guidance covering common cases.	5 / 5
Workflow Clarity	A clear sequenced pre-response checklist (lessons read → session logged → delegations → reviews) with an explicit verification step (`tail -1 .opencastle/logs/events.ndjson`) and a fix-now feedback loop satisfies the 5-anchor; the batch-logging validation cap is avoided since verification is present.	5 / 5
Progressive Disclosure	Good section organization with a well-signaled one-level reference ('See `.opencastle/logs/README.md` for full schema'), but no bundled reference files exist and the full schema is deferred to an external path rather than split into the bundle, leaving minor organization gaps per the 4-anchor.	4 / 5
	Total	18 / 20 Passed

Description

100%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 is exemplary: it states concrete capabilities in third person, gives an explicit 'Use when' clause with varied trigger scenarios, and enumerates natural trigger terms. It cleanly satisfies every dimension at the top anchor.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Logs sessions, tracks activity, records delegation decisions, and stores review/dispute outcomes as NDJSON audit trails' — with comprehensive coverage of the skill's capabilities, matching the 5-anchor.	5 / 5
Completeness	Clearly answers 'what' (the logging actions) and 'when' via 'Use when logging session activity, tracking work, recording decisions, building audit trails, capturing delegation history, or running pre-response verification checklists' with concrete trigger phrases, matching the 5-anchor.	5 / 5
Trigger Term Quality	Explicit 'Trigger terms: log, track activity, audit trail, session record, delegation log, NDJSON' gives comprehensive coverage of natural phrases plus the format extension a user would say, matching the 5-anchor.	5 / 5
Distinctiveness Conflict Risk	The NDJSON audit-trail / delegation / review-dispute niche is clearly bounded and its triggers (audit trail, delegation log, session record) are distinct from generic logging skills, giving minimal conflict risk per the 5-anchor.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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: monkilabs/opencastle
Path: src/orchestrator/skills/observability-logging/SKILL.md
Commit: fa0c341

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.