CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oss-growth

Activate for OSS adoption work -- README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles -- and any update to the maintained growth strategy at WIP/growth-strategy.md.

Quality

80%

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 ./.apm/skills/oss-growth/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-organized instruction skill: lean rule statements, a distinctive safety rule about the gitignored WIP/ directory, and clear activation triggers, with no padding or structure problems. The only soft spot is actionability — a few rules would land harder with one concrete example of the expected output.

DimensionReasoningScore

Conciseness

The body is lean and directive with zero padding: every line is either a trigger condition or an operational rule ('Every conversion surface needs a one-line hook, a runnable example, and a clear next step'), and it explains nothing Claude already knows. This matches the 5 anchor — every token earns its place — and clearly beats the 4 anchor's 'minor instances of over-explanation' since there are none.

5 / 5

Actionability

For an instruction-only skill the guidance is concrete and prescriptive: measurable requirements ('one-line hook, a runnable example, and a clear next step', 'top-level summary kept to one screen', 'Append-only for dated tactical notes') and hard commands ('Never stage or commit anything under WIP/'). It stays at 4 rather than 5 because some directives lack a concrete example of the expected output — e.g. what a growth-implication annotation or a 'one-line hook' should look like — which is the 'minor gaps' of the 4 anchor.

4 / 5

Workflow Clarity

There is no multi-step pipeline to sequence — this is a rule-based side-channel skill, and its rules are unambiguous, including the first-use bootstrap ('create it locally on first use') and a safety guardrail ('Never stage or commit anything under WIP/'). It holds at 4 rather than 5 because the interactions between rules are left implicit (e.g. when the 'never block specialist findings' rule versus the 'cut anything that dilutes the frame' rule applies, or in what order to act during a review), which is a minor gap rather than the missing-validation gaps of the 3 anchor.

4 / 5

Progressive Disclosure

The skill body is ~30 lines with two clean sections ('When to activate', 'Key rules') and no external reference files needed — no references/, scripts/, or assets/ exist in the bundle — so per the under-50-lines guideline, well-organized sections alone earn the 5. The single outbound link to the persona file is clearly signaled and one level deep.

5 / 5

Total

18

/

20

Passed

Description

66%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 distinctive, well-triggered description for a narrow niche that names concrete surfaces rather than generic domains. Its main weakness is the missing 'what': it says when to activate but never states what the skill does, leaving completeness as the weakest dimension.

Suggestions

Add an explicit 'what' clause stating the skill's actions, e.g. 'Reviews changes for growth impact, maintains WIP/growth-strategy.md, and annotates specialist findings with adoption implications. Activate for ...' — this would lift completeness from 3 to 4-5.

Include a few more natural synonyms users might say (e.g. 'docs/onboarding', 'landing page', 'launch post') to broaden trigger coverage without adding vague fluff.

Qualify the generic terms 'templates' and 'quickstart' with the OSS-growth context (as the body already does for 'templates/ starter projects') to reduce overlap risk with documentation or scaffolding skills.

DimensionReasoningScore

Specificity

The description enumerates several concrete surfaces — 'README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles' and a specific path 'WIP/growth-strategy.md' — which is several specific items with only minor coverage gaps. It is not a 5 because the surfaces are named without corresponding concrete actions (what is actually done to them), keeping it at 'several specific items, minor gaps' rather than comprehensive coverage.

4 / 5

Completeness

The 'when' is explicit and concrete ('Activate for OSS adoption work -- README conversion surfaces, ... and any update to the maintained growth strategy at WIP/growth-strategy.md'), but the 'what' is only vaguely conveyed — 'Activate for OSS adoption work' never states what the skill actually does. It is better than the 2 anchor (which has no usable 'what' or a vague one with no 'when') because the trigger list gives it substance, but it cannot reach 4 without an explicit statement of the skill's actions.

3 / 5

Trigger Term Quality

Natural trigger phrases like 'quickstart', 'release announcements', 'templates', 'story angles', and 'growth strategy' are terms a user would plausibly say during OSS adoption work, giving good keyword coverage. It falls short of the 5 anchor because common synonyms and variations (e.g. 'launch post', 'docs', 'onboarding', 'landing page') are missing, but it clearly exceeds the 3 anchor's 'missing common variations' level.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — OSS adoption/growth — with distinctive triggers like 'contributor funnel', 'story angles', and the 'WIP/growth-strategy.md' path that no other skill would claim. It does not reach 5 because generic terms like 'templates' and 'quickstart' carry minor overlap risk with documentation or scaffolding skills if uttered outside the OSS-growth context.

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

microsoft/apm

Path

.apm/skills/oss-growth/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.