CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

contact-template

Contact / communications plan generator — primary operator, escalation chain, abort signal recipient, external SOC endpoint, blackout windows.

Quality

76%

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 ./packages/decepticon/decepticon/skills/standard/soundwave/contact-template/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, mostly lean instruction skill with a clearly sequenced workflow, concrete formats and examples, a validation checklist, and an accurate inline schema table. Its main gaps are the absence of an error-recovery feedback loop after validation and a couple of abstract operations (SOC endpoint POST, no full example document).

Suggestions

Add a short feedback loop after the Validation Checklist: what to do when ContactPlan validation fails (fix fields, re-validate, only then write).

Show a minimal complete plan/contact.json example so the output format is copy-paste ready.

Specify how to POST to the external SOC endpoint (method, payload, expected response) rather than just recording the URL.

DimensionReasoningScore

Conciseness

The body is efficient: it assumes domain competence, specifies only project-specific conventions (RoE escalation_contacts, ISO 8601 range formats, the ContactPlan schema), and avoids generic explanations. Minor over-explanation keeps it below the 5 anchor — e.g. the white-cell/blue-cell/red-cell framing paragraph and the "Common blackouts" bullet list could be trimmed without losing actionability.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: a deterministic resolution rule ("If exactly one contact has the role... use that; otherwise ask"), concrete channel formats ("Signal, email, PagerDuty service-key, Slack channel", "tel: / signal: / mailto: style"), exact ISO 8601 examples, an output path (plan/contact.json), and a full field-level schema table. Not a 5 because a couple of operations are left abstract — e.g. how the agent should POST to the external SOC endpoint and no complete example contact.json document.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with defaults (15-minute response window), and a Validation Checklist with explicit pass conditions precedes writing plan/contact.json against decepticon.core.schemas.ContactPlan. It falls short of the 5 anchor because no error-recovery feedback loop is described (what to do when schema validation fails or the primary is unresolvable); the operation is plan generation, not destructive/batch, so no 3-cap applies.

4 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist, so nothing external to navigate; the body is well-sectioned (When to Use, Workflow, Validation Checklist, Anti-patterns, Output, Document schema) and every internal reference (plan/contact.json, ContactPlan) is to the output artifact, not to a missing file. The ~25-line document schema table inlined in SKILL.md is content that could live in a reference file, which keeps it at the 4 anchor (good structure, minor organization gaps) rather than 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 compact, specific description that clearly conveys what the skill produces, with strong natural trigger terms and minimal conflict risk. Its main weakness is the absence of an explicit "Use when..." clause in the description itself, which caps completeness and leaves trigger discovery to the metadata field.

Suggestions

Append an explicit when-clause to the description, e.g. ". Use when the user asks for a contact plan, escalation chain, who to notify, or blackout windows."

Add a few missing natural trigger synonyms such as "who do we notify", "paging", or "on-call" to broaden keyword coverage.

Lead with an action verb ("Generates a contact/communications plan...") to make capabilities read as actions rather than a component list.

DimensionReasoningScore

Specificity

The description names the domain ("Contact / communications plan generator") and enumerates concrete components — "primary operator, escalation chain, abort signal recipient, external SOC endpoint, blackout windows" — which map directly to the skill's output fields. It falls just short of the 5 anchor because the items are plan components rather than multiple explicit actions, and no act/validate verbs appear beyond "generator".

4 / 5

Completeness

The "what" is clear (a generator for a contact/communications plan with five concrete components), but the description field contains no "Use when..." clause or equivalent trigger guidance — the when-guidance lives only in a separate metadata field, not the description. Per the rubric guideline, a missing explicit when-clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural phrases users would say are present: "contact", "communications plan", "escalation chain", "blackout windows", "SOC". A few common variations ("who do we notify", "paging", "on-call", "deconfliction") are missing, which matches the 4 anchor (good coverage, a few natural terms missing) rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Contact / communications plan generator — primary operator, escalation chain, abort signal recipient, external SOC endpoint, blackout windows" defines a clear niche with distinct trigger terms (escalation chain, blackout windows, SOC endpoint) that no generic skill would claim. It is not above the 5 anchor because there is no clearer fit; it is not below because overlap with other skills is minimal.

5 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

PurpleAILAB/Decepticon

Path

packages/decepticon/decepticon/skills/standard/soundwave/contact-template/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.