CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

emitting-api-events

Build event-driven APIs with webhooks, Server-Sent Events, and real-time notifications. Use when building event-driven API architectures. Trigger with phrases like "add webhooks", "implement events", or "create event-driven API".

Quality

83%

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

78%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 instructional skill body with specific, actionable guidance, a logical step sequence, and excellent progressive disclosure into three real one-level-deep reference files. Its main weaknesses are moderate redundancy in the Overview and the absence of inline validation checkpoints between workflow steps.

Suggestions

Trim the Overview and Prerequisites sections to remove restatement of description content and compress the broker/storage lists into a single sentence, tightening conciseness toward a lean overview-plus-references structure.

Insert explicit validation checkpoints between workflow steps (e.g., 'verify the emitter publishes an order.created event to the broker before building webhook delivery on top of it') rather than relying solely on the final integration-test step.

Add one short inline signing/verification snippet (e.g., computing and verifying the HMAC-SHA256 signature header) so the delivery guidance is copy-paste ready rather than deferred entirely to references/implementation.md.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no tutorials on concepts Claude already knows — sections like the Error Handling table and Instructions carry concrete detail ('Retry with exponential backoff; deactivate subscription after 5 consecutive failures') — but the Overview ('Build event-driven APIs using outbound webhooks, Server-Sent Events (SSE), and message broker integration. Implement event emission from API mutations, event schema registry, subscriber management...') substantially restates the description and Instructions, and the Prerequisites list could be tightened. This matches anchor 4, 'Efficient; minor instances of over-explanation that could be trimmed,' rather than 5 because of that redundancy.

4 / 5

Actionability

Guidance is highly concrete — naming convention ('resource.action' with e.g. 'order.created'), enumerated schema fields, exact endpoints ('POST /webhooks', 'GET /events/stream'), HMAC-SHA256 signing, a full backoff schedule (1min, 5min, 30min, 2hr, 24hr), and heartbeat details (':keepalive\n\n' every 15s). Per the scoring note an instruction-only skill is not penalized for lacking code, but it stops short of copy-paste-ready snippets, so anchor 4 ('Mostly executable guidance... minor gaps') fits better than 5.

4 / 5

Workflow Clarity

The 8 numbered steps form a coherent, logical sequence (identify mutations → schemas → emitter → subscription API → delivery → SSE → DLQ → integration tests). It is not a 5 because validation appears only as a terminal test-writing step rather than explicit checkpoints between steps (e.g., verify the emitter publishes before building delivery on top of it); not a 3 since step 8 does mandate integration tests covering each subsystem.

4 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references — links to references/implementation.md ('full implementation guide'), references/errors.md ('comprehensive error patterns'), and references/examples.md ('additional examples'), all of which exist in the bundle and contain no nested references. This matches the anchor 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

17

/

20

Passed

Description

83%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 strong description that clearly states what the skill does, when to use it, and which phrases trigger it, using third-person voice without padding. Trigger coverage is good but could include more synonyms (SSE, streaming, notifications, pub/sub) to reach the top level.

DimensionReasoningScore

Specificity

The description names the domain ('event-driven APIs') and several concrete capabilities ('webhooks, Server-Sent Events, and real-time notifications'), matching the anchor 'Lists several specific actions; minor gaps in coverage'. It falls short of a 5 because delivery guarantees, subscriber management, and event schema work mentioned only in the body are not reflected, and the items listed are technologies rather than fully enumerated actions.

4 / 5

Completeness

It explicitly answers 'what' ('Build event-driven APIs with webhooks, Server-Sent Events, and real-time notifications') and 'when' ('Use when building event-driven API architectures'), then adds concrete trigger phrases, matching the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'. A 4 would require the 'when' to be only implicit or less specific; here it is explicit and paired with trigger examples.

5 / 5

Trigger Term Quality

Trigger phrases 'add webhooks', 'implement events', 'create event-driven API' are natural phrasings a user would say, giving good keyword coverage. It is not a 5 because common variations such as 'SSE', 'streaming', 'push notifications', or 'pub/sub' are absent as trigger terms.

4 / 5

Distinctiveness Conflict Risk

The webhook/SSE/event-emission niche is mostly distinct with clear triggers, but phrases like 'add webhooks' or 'implement events' could overlap with a dedicated webhooks-only or pub/sub skill, matching 'Mostly distinct; minor overlap risk with closely related skills' rather than the clear-niche 5.

4 / 5

Total

17

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/api-development/api-event-emitter/skills/emitting-api-events/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.