CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

78%

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

72%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, well-organized instruction-only skill that respects Claude's competence and keeps references shallow. It loses points for mandating concrete artifacts (hooks, runnable examples, templates) without providing a single example, and for leaving the failure-handling checkpoint implicit.

Suggestions

Add one or two concrete examples of a 'one-line hook, runnable example, clear next step' so the rule is copy-paste actionable rather than abstract.

Specify the feedback loop when a conversion surface does not meet the standard (e.g., annotate the gap with growth implications and escalate to the CEO, or fix and re-check).

Consider a short reference template for release/social copy so the persona has a concrete starting point.

DimensionReasoningScore

Conciseness

Roughly 30 lines with no concept re-explanation or padding; guidance like 'Every conversion surface needs a one-line hook, a runnable example, and a clear next step' earns its tokens.

3 / 3

Actionability

Rules are concrete and directive ('one-line hook, a runnable example, and a clear next step'; 'Never stage or commit anything under WIP/'), but it mandates artifacts (hooks, examples, templates) without showing a single concrete example to copy.

2 / 3

Workflow Clarity

Activation triggers and key rules are clearly listed, but there is no explicit checkpoint for what to do when a conversion surface fails the hook/example/next-step test -- fix, annotate, or escalate is left implicit.

2 / 3

Progressive Disclosure

Under 50 lines with well-organized sections (When to activate, Key rules); the only references -- the persona agent file and the gitignored WIP/growth-strategy.md -- are one level deep and clearly signaled.

3 / 3

Total

10

/

12

Passed

Description

85%Weight 40%Scale 1-3

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, specific description with an explicit activation clause covering both activities and a file-path trigger. Its main weakness is trigger-term naturalness -- several phrases are maintainer jargon rather than words a user would naturally say.

Suggestions

Reword jargon terms like 'conversion surfaces' and 'contributor funnel' toward phrasings users actually say (e.g., 'README and quickstart improvements', 'onboarding new contributors').

Add common trigger variations such as 'launch post', 'social announcement', or 'getting started docs' alongside the existing terms.

DimensionReasoningScore

Specificity

Enumerates multiple concrete surfaces and actions -- 'README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles' -- beyond merely naming the domain.

3 / 3

Completeness

States both what it does (the enumerated growth surfaces plus strategy maintenance) and when to use it via the explicit 'Activate for OSS adoption work ... and any update to the maintained growth strategy at WIP/growth-strategy.md' trigger clause.

3 / 3

Trigger Term Quality

Natural terms like 'README', 'quickstart', and 'release announcements' are present, but phrasing leans on internal vocabulary ('conversion surfaces', 'contributor funnel', 'story angles') and misses common variations a user would say verbatim.

2 / 3

Distinctiveness Conflict Risk

Carves a clear OSS-adoption/growth niche anchored by the distinct WIP/growth-strategy.md trigger, making it unlikely to fire for the wrong skill despite minor overlap with generic docs skills.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
microsoft/apm
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.