CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

freecodecamp-style

Author and review freeCodeCamp /news tutorials. Use when writing an fCC tutorial, a Hashnode draft, or a dual-submit checklist. It does not set kit house voice (that's `docs-writing-style`).

Quality

88%

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

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

The body is a well-engineered instruction skill: terse rule bullets and tables, copy-paste templates for every output mode, phase-gated workflow with validation checkpoints, and a clean overview-to-references split that was verified against the actual bundle. The only cost is redundancy — key rules (dual-submit, ToC, headline form) are restated in four to five sections, which inflates the token budget without adding information.

DimensionReasoningScore

Conciseness

The language is uniformly lean and assumes Claude's competence ("Use direct headlines: 'How to Build X with Y' not 'Building X with Y'", "Replace 'e.g.' → 'for example'") with zero explanation of known concepts, fitting the efficient anchor. It is not a 5 because several rules repeat across the Phases table, Guardrails, Quick rules, Phase gates, and Quality checklist (the dual-submit rule and 'draft URL not preview URL' appear four-plus times), which could be trimmed.

4 / 5

Actionability

Guidance is copy-paste ready throughout: the email body template ("Subject: freeCodeCamp draft for review: <headline>"), the review output format ("FAIL <criterion>: <problem> → fix: <action>"), a 12-item dual-submit checklist, and concrete headline and slug examples ("javascript-array-tutorial"). Per the instruction-only scoring note, this covers the common cases fully — the anchor-5 fit rather than 4, which would require minor gaps.

5 / 5

Workflow Clarity

The Phases table sequences Capture→Package→Draft→Integrity→Submit→Review, and the explicit 'Phase gates' section places a validation checkpoint between every phase ("Capture → Package: Topic and depth tier chosen? Research enough for ≥500 words?"), plus numbered per-mode workflows, a review feedback loop (fails first, one top fix), and post-feedback recovery steps ("human updates, then emails that edits are done"). This matches the anchor requiring explicit validation steps, feedback loops, and checklists — not 4, where checkpoints would only be 'mostly' present.

5 / 5

Progressive Disclosure

The body stays an overview and clearly signals one-level-deep references with scope labels — "Full style rules, examples, and anti-patterns: load `references/publication-style-guide.md`", "Hashnode account, dual-submit, ToC…: load `references/hashnode-workflow.md`", "Plagiarism examples…: load `references/integrity-and-policy.md`", "Review scoring checklist: load `references/review-rubric.md`" — and all four files exist in references/ with sibling-level (not nested) cross-links. This matches the clear-overview anchor exactly; not 4 because navigation and split placement have no organization gaps.

5 / 5

Total

19

/

20

Passed

Description

82%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: third-person, concise, with an explicit and concrete 'Use when' clause and active disambiguation from a neighboring skill. The main gap is that the 'what' under-sells the skill's actual scope (packaging, integrity checks, dual-submit workflow), capping specificity at the 1-2-action level.

Suggestions

Enumerate the main capabilities in the first line, e.g. "Author, package, review, and submit freeCodeCamp /news tutorials — headlines, slugs, tags, voice and structure rules, integrity checks, and the Hashnode dual-submit workflow" to lift specificity from anchor 3.

Add common trigger synonyms such as "freeCodeCamp article", "/news publication", or "submitting to freeCodeCamp" to the Use-when clause for broader natural-term coverage.

DimensionReasoningScore

Specificity

"Author and review freeCodeCamp /news tutorials" names the domain plus two concrete actions, but does not enumerate the packaging, integrity, and dual-submit capabilities the skill actually covers — matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because the description lists no more than the two author/review actions rather than several specific capabilities.

3 / 5

Completeness

It explicitly answers both: what ("Author and review freeCodeCamp /news tutorials") and when ("Use when writing an fCC tutorial, a Hashnode draft, or a dual-submit checklist") with concrete trigger phrases. It is not a 4 because the when-clause is already fully explicit and specific rather than something that 'could be more explicit'.

5 / 5

Trigger Term Quality

The when-clause supplies natural phrases users would say — "writing an fCC tutorial", "a Hashnode draft", "a dual-submit checklist" — giving good keyword coverage. It falls short of the 5 anchor because common variations like "freeCodeCamp article", "/news publication", or "submit to freeCodeCamp" are missing.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (freeCodeCamp /news tutorials, Hashnode drafts) with distinct triggers, and the clause "It does not set kit house voice (that's `docs-writing-style`)" explicitly disambiguates from the closest sibling skill, minimizing conflict risk.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

saif-shines/devex-kit

Path

plugins/documentation/skills/freecodecamp-style/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.