CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

unified-notifications-ops

Operate notifications as one ECC-native workflow across GitHub, Linear, desktop alerts, hooks, and connected communication surfaces. Use when the real problem is alert routing, deduplication, escalation, or inbox collapse.

Quality

77%

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/unified-notifications-ops/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, disciplined instruction-only skill: a clear five-step workflow, a concrete severity model, explicit routing/recommendation rules, and a copy-ready output template. The main improvement levers are trimming a few rhetorical passages and adding a lightweight confirmation checkpoint between the inventory and design phases.

DimensionReasoningScore

Conciseness

The body is lean and bullet/table-driven with no explanations of concepts Claude already knows — the severity table and output template earn their tokens. It is not a 5 because of a few rhetorical flourishes ('The real problem is not a missing ping', 'The job is to turn scattered events into one operator surface with: clear severity / clear ownership...') that restate the description without adding operational value.

4 / 5

Actionability

Concrete, executable-for-a-design-skill guidance: a four-class severity table with examples and default handling, a five-step workflow with per-step specifics, decision rules, and a copy-ready output-format template. As an instruction-only skill the absence of code is not penalized (per scoring notes), but a few workflow steps stay at the level of high-level hints ('Call out what ECC already owns') rather than specific instructions, keeping it below anchor 5.

4 / 5

Workflow Clarity

A clearly sequenced five-step workflow (inventory → decide interruption → collapse duplicates → design workflow → return action-biased design) with concrete per-step checklists. No explicit validation checkpoints exist, but the skill is analytical/design work with no destructive or batch operations, so the validation cap does not apply; minor implicit-checkpoint gaps (e.g. no 'confirm the inventory with the user before designing') keep it at 4 rather than 5.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), and the single SKILL.md is well-organized with clear section headers that make navigation easy. At ~185 lines it exceeds the under-50-line simple-skill case, and content like the severity model or output format could plausibly live in a reference file for an ECC suite that clearly has related skills, so it sits at 'good structure, minor organization gaps' rather than a 5.

4 / 5

Total

16

/

20

Passed

Description

70%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 description with an explicit and concrete 'Use when...' clause and good natural trigger terms, held back mainly by an abstract single-verb 'what' statement. It would score higher if it enumerated the concrete operations it performs (inventory sources, classify severity, route, collapse duplicates).

Suggestions

Replace the abstract 'Operate notifications as one ECC-native workflow' with 2-3 concrete capability verbs, e.g. 'Inventory notification sources, classify alert severity, route events to the right channel, and collapse duplicates across GitHub, Linear, hooks, and desktop alerts.'

Add common user phrasings as triggers — 'notifications are too noisy', 'too many alerts', 'consolidate alerts' — to broaden natural trigger coverage.

Clarify what 'ECC-native' means in the description itself (or drop the jargon) so the distinctiveness of the skill is legible to a user who has never seen the ECC ecosystem.

DimensionReasoningScore

Specificity

The description names the domain ('notifications across GitHub, Linear, desktop alerts, hooks') but the 'what' is a single abstract action — 'Operate notifications as one ECC-native workflow'. The concrete verbs (routing, deduplication, escalation) appear only as trigger conditions rather than stated capabilities, so it sits between anchor 3 ('names domain and 1-2 concrete actions') and anchor 4 ('several specific actions'); it is not a 4 because no list of concrete performed actions is given.

3 / 5

Completeness

Both parts are present: an explicit 'Use when the real problem is alert routing, deduplication, escalation, or inbox collapse' (concrete trigger phrases) and a what-clause ('Operate notifications as one ECC-native workflow across GitHub, Linear, desktop alerts, hooks'). Not a 5 because the 'what' is somewhat abstract compared to the anchor-5 example's enumeration of concrete capabilities.

4 / 5

Trigger Term Quality

Phrases like 'alert routing', 'deduplication', 'escalation', 'inbox collapse', 'desktop alerts', and 'hooks' are natural things a user would say when needing this skill. It falls short of anchor 5 only because common variations and synonyms ('notifications are too noisy', 'mute/snooze', specific channels like Slack or email as user-spoken terms) are missing.

4 / 5

Distinctiveness Conflict Risk

The niche — consolidating fragmented notification surfaces into one ECC-native lane — is distinct with clear triggers. Minor overlap risk remains with adjacent operational skills the body itself references (github-ops, project-flow-ops), keeping it below anchor 5.

4 / 5

Total

15

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/unified-notifications-ops/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.