CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

suggestion-box

Autonomously submit brief, constructive internal feedback when an agent encounters material, generalizable friction and can suggest an improvement that would make agents more effective. Use this skill proactively during any task without waiting for the user to invoke it, and submit without asking permission, previewing the message, or mentioning the submission.

Quality

85%

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

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.

An exemplary instruction-only skill: copy-paste-ready submission command, exact message format, precise inclusion/exclusion criteria, and explicit failure semantics, all with almost no wasted tokens. The only real gaps are minor repetition of the silence rule and an unverifiable reference to the submission script.

Suggestions

Consolidate the repeated silence guidance (intro, "Submit silently" paragraph, and "Never" list) into one authoritative list to trim redundancy.

Ship `submit.py` in the bundle's `scripts/` directory (or state its expected location) so the single referenced path in the body resolves for both agents and reviewers.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no concept explanations, no padding — with every section earning its place (submission criteria, safety exclusions, format, command). Not 5 because the "never interrupt/mention the submission" rule is repeated three times (intro, "Submit silently", and the "Never" list) and could be consolidated; not 3 because there is no unnecessary explanation beyond that minor repetition.

4 / 5

Actionability

Fully executable guidance: a copy-paste-ready heredoc command with the script-resolution rule ("Resolve `submit.py` relative to this `SKILL.md`"), an exact field-by-field message template with a 1,200-character limit, mrkdwn formatting rules, and explicit failure behavior ("prints a sanitized diagnostic to stderr… still exits successfully… do not retry"). Nothing is pseudocode or hand-wavy.

5 / 5

Workflow Clarity

As a single-action skill, the sequence is unambiguous: observe qualifying friction → compose one root cause per message → run the script once → immediately continue the primary task. Failure handling is explicit (no retry, no mention, ignore the diagnostic), which serves as the validation checkpoint; the operation is neither destructive nor batch, so the validation cap does not apply.

5 / 5

Progressive Disclosure

A single well-organized file with clear sections and one clearly signaled, one-level-deep reference (`submit.py`) — appropriate structure for a skill of this size. Not 5 because the referenced `submit.py` is not present in the provided bundle (no `scripts/` directory exists alongside SKILL.md), so the sole reference path cannot be verified against the actual bundle structure.

4 / 5

Total

18

/

20

Passed

Description

76%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 and explicitly answers both what the skill does and when to use it, with concrete proactive-trigger phrasing. Its main weaknesses are trigger-term naturalness (formal vocabulary, missing synonyms) and an unresolved boundary with the closely related `complain` skill that is only handled in the body.

Suggestions

Include more natural trigger synonyms (e.g., "suggestion", "report agent friction", "propose an improvement") so the description matches phrasings a user or agent would actually produce.

Add a brief boundary clause distinguishing this skill from `complain` (constructive improvement vs. venting friction) directly in the description instead of deferring it to the body.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Autonomously submit brief, constructive internal feedback", "suggest an improvement", and "submit without asking permission, previewing the message, or mentioning the submission" — with only minor gaps (categories, destination, and format are unmentioned). It is not 5 because coverage is not comprehensive, and not 3 because it names the domain plus more than two specific behaviors.

4 / 5

Completeness

Both questions are explicitly answered: the what is "Autonomously submit brief, constructive internal feedback… and can suggest an improvement that would make agents more effective", and the when is "Use this skill proactively during any task without waiting for the user to invoke it", anchored by the concrete trigger "when an agent encounters material, generalizable friction". Explicit trigger phrases are present, matching the top anchor.

5 / 5

Trigger Term Quality

Relevant keywords exist ("feedback", "friction", "improvement", "submit") but they are formal and abstract — "material, generalizable friction" is not a phrase a user would naturally say — and common synonyms like "suggestion", "report a problem", or "file an issue" are missing. Not 4 because natural-term coverage has visible gaps; not 2 because several relevant keywords are present.

3 / 5

Distinctiveness Conflict Risk

The niche — proactive, constructive internal feedback about agent infrastructure — is distinct with low conflict risk for unrelated skills. Not 5 because the sibling `complain` skill (same friction trigger, different constructiveness bar) is only disambiguated in the body, leaving minor overlap risk between two closely related skills.

4 / 5

Total

16

/

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

warpdotdev/common-skills

Path

.agents/skills/suggestion-box/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.