CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-sentinel

Set up Sentinel production error capture in your own Convex deployment.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/convex-sentinel/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 an impressively tight, well-structured overview that correctly prioritizes the privacy/redaction rules and sequences the workflow clearly. Its main weakness is actionability: every step is direction rather than executable code, leaving Claude to reconstruct the install command, config wiring, and client SDK setup on its own.

Suggestions

Add copy-paste-ready snippets for the two setup steps: the npm install command and the actual 'sentinel' wiring in convex/convex.config.ts, plus a minimal React error-boundary example for step 2.

Include an explicit verification checkpoint after wiring, e.g. 'Trigger a test error, then run "convex data <sentinel errors table>" to confirm capture and redaction are working.'

Deduplicate the redaction and data-locality statements — currently stated in the intro, workflow, and Rules — keeping the enforcement emphasis in Rules only.

DimensionReasoningScore

Conciseness

The ~20-line body is lean, assumes Claude's competence (no explanation of what Convex or an error boundary is), and uses dense, purposeful lines. It falls just short of the score-5 anchor because a few statements are duplicated — redaction is stated in the intro, again as workflow step 3, and again as a rule; 'Data never leaves the user's deployment' appears in both intro and Rules — minor redundancy that could be trimmed.

4 / 5

Actionability

Concrete artifacts are named ('app.use(sentinel)' in 'convex/convex.config.ts', 'convex data', 'run-once-query', the monitor's 'prod_error' event, the 'triage' cron), but nothing is fully executable: there is no install command, no copy-paste snippet for convex.config.ts, and step 2 ('a React error boundary plus window.onerror/unhandledrejection and breadcrumbs') is descriptive rather than runnable. This matches the anchor 'Some concrete guidance but incomplete; pseudocode instead of executable code; missing key details' rather than the mostly-executable bar of score 4.

3 / 5

Workflow Clarity

The five numbered steps form a clear, correctly ordered sequence (install → wire client → redaction defaults → read/react → optional cron) with specific commands at each stage. It sits at 'Clear sequence with most checkpoints present; minor validation gaps' rather than 5 because no explicit verification step exists (e.g., confirming captured errors appear in the table after wiring) — though step 4's read step serves as an implicit check, and no destructive or batch operation triggers the score-3 cap.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (references/, scripts/, and assets/ are absent) and no need for external references; content is organized into a clear overview paragraph, a numbered Workflow section, and a Rules section. Per the rubric's simple-skill guidance, this earns the top anchor for well-organized sections with no buried or nested references.

5 / 5

Total

16

/

20

Passed

Description

57%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 short, specific to its niche, and highly distinctive, but it functions only as a 'what' statement. It lacks any explicit 'when to use' trigger guidance and omits natural synonym terms users might say, which caps both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to capture, monitor, or react to production errors in a Convex app, or mentions Sentinel, @convex-dev/sentinel, or crash/error reporting in Convex.'

Include natural synonyms users would say — 'error monitoring', 'crash reporting', 'production error logs' — alongside 'error capture' to improve trigger-term coverage.

Mention one or two more concrete capabilities (e.g. 'capture server function failures and client crashes, redacted, into a table in your own deployment') to raise specificity from a single 'Set up' action.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Sentinel production error capture in your own Convex deployment') but offers only a single action verb, 'Set up', with no mention of the capture pipeline's other capabilities (redaction, reacting to errors, self-healing triage). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — score 4 would require several specific actions, score 2 would leave the domain vague, which it is not.

3 / 5

Completeness

The 'what' is stated clearly ('Set up Sentinel production error capture in your own Convex deployment'), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines this caps completeness at 3, matching the anchor 'Has a clear "what" but "when" is missing or only weakly implied'.

3 / 5

Trigger Term Quality

Relevant keywords are present ('production error capture', 'Convex deployment', 'Sentinel') but common variations users would naturally say are missing: 'error monitoring', 'crash reporting', 'log production errors', or the package name '@convex-dev/sentinel'. This fits 'Some relevant keywords but missing common variations or synonyms' rather than the comprehensive coverage of score 4.

3 / 5

Distinctiveness Conflict Risk

The description names a specific product ('Sentinel'), a specific platform ('Convex deployment'), and a specific concern ('production error capture'), giving it a clear niche with minimal overlap risk against generic error-handling or monitoring skills. It clearly matches the anchor 'Clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

14

/

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

openclaw/clawhub

Path

.agents/skills/convex-sentinel/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.