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

69%

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

Quality

Content

68%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 policy/persona skill that respects the token budget almost perfectly — no padding, no over-explanation, clearly scoped activation triggers and guardrails. Its weakness is actionability and workflow: directives like "reinforce the frame" and "escalate to the CEO" lack concrete mechanics, and the growth-strategy file lifecycle is implied rather than sequenced. Fixing the dangling persona reference and adding one exemplar hook would resolve the remaining gaps.

Suggestions

Add a one-line exemplar of a good conversion-surface hook (e.g. a before/after README hero snippet) so the "one-line hook, runnable example, clear next step" rule is executable rather than evaluative.

Specify what "annotate them with growth implications and escalate to the CEO" concretely means — where the annotation goes and what the escalation action is.

Fix or inline the persona reference at ../../../.apm/agents/oss-growth-hacker.agent.md — the relative path does not resolve from the skill's directory.

DimensionReasoningScore

Conciseness

The 37-line body is lean and rule-dense: no explanations of concepts Claude already knows, no padding, every line carries a directive ("Every conversion surface needs a one-line hook, a runnable example, and a clear next step"). Anchor 5 fits; there is nothing to trim, so 4 is excluded.

5 / 5

Actionability

Some concrete, executable guidance exists ("Append-only for dated tactical notes; concise top-level summary kept to one screen", "Never stage or commit anything under WIP/", the hook/example/next-step criteria), but key execution details are missing: no example of what a good hook looks like, no mechanics for "escalate to the CEO", and abstract directives like "Reinforce the 'package manager for AI-native development' frame... Cut anything that dilutes it". Anchor 3 fits; not 4 because several directives lack the specifics to execute them, not 2 because there is real concrete guidance.

3 / 5

Workflow Clarity

The activation checklist ("When to activate") is clear, but no sequenced process is laid out — the WIP/growth-strategy.md lifecycle ("create it locally on first use", "append-only for dated tactical notes", "concise top-level summary kept to one screen") is scattered across rules rather than presented as a sequence, and there are no validation checkpoints. Anchor 3 fits; not 4 because steps are not explicitly ordered, not 2 because the structure is coherent and no destructive/batch operation requires the validation cap.

3 / 5

Progressive Disclosure

The body is under 50 lines with no bundle directories, and is cleanly organized into "When to activate" and "Key rules" sections with content appropriately inlined. Anchor 4 rather than 5 only because the sole external reference — the persona link at ../../../.apm/agents/oss-growth-hacker.agent.md — is a relative path that does not resolve from the skill's own directory and is not clearly signposted beyond the bare link; not 3 because nothing that belongs in a separate file is inlined.

4 / 5

Total

15

/

20

Passed

Description

56%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.

The description is concise and trigger-rich with an explicit activation clause, but it never says what the skill actually does — the only capability statement is the vague "OSS adoption work". Adding one or two concrete action verbs would lift specificity and completeness substantially. It stays appropriately brief and free of buzzword padding.

Suggestions

State the what explicitly with concrete verbs, e.g. "Optimizes README conversion surfaces, drafts release announcements and quickstarts, and maintains the growth strategy at WIP/growth-strategy.md."

Add natural trigger synonyms users might say — "docs", "launch post", "onboarding", "social copy" — to broaden keyword coverage.

Keep the third-person, terse style while making the surface list read as actions rather than nouns (e.g. "rewrites README hero sections, drafts launch copy").

DimensionReasoningScore

Specificity

The description names the domain ("OSS adoption work") and lists specific surfaces ("README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles"), but states no concrete actions the skill performs — no verbs like rewrite, audit, or draft. Anchor 2 (domain named, actions minimal/generic) fits; it is not 3 because no concrete action is articulated, and not 1 because the surfaces are specifically named rather than abstract.

2 / 5

Completeness

"Activate for..." provides explicit when-guidance (satisfying the 'Use when' equivalent requirement), but the what is only the vague phrase "OSS adoption work" — no statement of what the skill actually does. Anchor 3 (one of what/when clear, the other weak) fits; not 4 because the what is genuinely vague rather than the when being merely improvable.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "README", "quickstart", "templates", "release announcements", "contributor funnel", "story angles", plus the distinctive "WIP/growth-strategy.md" path. It falls short of 5 because common synonyms a user might say ("docs", "launch", "onboarding", "social copy" variants) are absent, and it is above 3 because the term list is broad and natural, not partial.

4 / 5

Distinctiveness Conflict Risk

A clear niche (OSS adoption/growth) with distinctive triggers including the unique WIP/growth-strategy.md path, but terms like "README" and "templates" carry minor overlap risk with general docs/writing skills. Not 5 due to that overlap; not 3 because the combined trigger set is highly unlikely to fire the wrong skill.

4 / 5

Total

13

/

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

.agents/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.