CtrlK
BlogDocsLog inGet started
Tessl Logo

method-shorthand-jsdoc

Method shorthand in return objects for JSDoc preservation. Use when factory functions have internal helpers that should expose docs, or hovering over returned methods shows no JSDoc.

71

Quality

87%

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

85%

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

A highly actionable, well-structured skill with concrete code and a crisp decision rule; its main weakness is repetition across the three getEpoch renderings and some re-explanation of `this`-binding fundamentals.

Suggestions

Collapse the Problem, Solution, and Real Example getEpoch blocks into a single before/after pair plus one real excerpt to remove triplicated code and trim tokens.

Shorten "Arrow Functions Don't Work" to a one-line caveat with a minimal snippet instead of re-explaining that arrow functions lack their own `this`.

Drop or repurpose the "Same content as article" reference, since pointing to a duplicate does not add a deeper level of detail.

DimensionReasoningScore

Conciseness

Mostly efficient and focused, but the getEpoch example recurs three times (Problem, Solution, Real Example), a createService BAD/GOOD pair reiterates the same point, and sections like "Arrow Functions Don't Work" re-explain `this`-binding basics Claude already knows, so it could be tightened.

2 / 3

Actionability

Provides fully executable before/after TypeScript snippets, a real `head-doc.ts` excerpt, and concrete BAD/GOOD patterns that are copy-paste ready with specific `this.method()` guidance.

3 / 3

Workflow Clarity

This is a single, unambiguous refactor whose Decision Rule explicitly separates "move in" from "keep separate" conditions; per the simple-skill note a clear single action with explicit criteria scores 3, and no destructive/batch operation requires validation checkpoints.

3 / 3

Progressive Disclosure

The body is organized into clear, signaled sections with one-level-deep references in a References section ("See [Closures Are Better Privacy Than Keywords]..."); no bundle files are present, and the external article links are appropriately signaled rather than nested.

3 / 3

Total

11

/

12

Passed

Description

90%

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 tight, third-person description with an explicit Use-when trigger and natural terms; its only weakness is naming a single action rather than enumerating multiple concrete capabilities.

DimensionReasoningScore

Specificity

Names one concrete action ("Method shorthand in return objects for JSDoc preservation") but does not list multiple distinct actions, so it sits at the 'names domain and some actions' anchor rather than the multiple-actions anchor.

2 / 3

Completeness

Clearly states both what it does and when to use it via an explicit "Use when factory functions have internal helpers that should expose docs, or hovering over returned methods shows no JSDoc" trigger, matching the both-what-and-when anchor.

3 / 3

Trigger Term Quality

Covers natural terms a TypeScript user would actually say — "JSDoc", "factory functions", "internal helpers", and "hovering over returned methods shows no JSDoc" — giving good trigger coverage.

3 / 3

Distinctiveness Conflict Risk

Occupies a narrow, specific niche (JSDoc preservation via method shorthand) with a distinct trigger unlikely to fire for unrelated skills; the related factory-function-composition skill targets a different concern.

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: 3 suspicious

Warning

Total

15

/

16

Passed

Repository
EpicenterHQ/epicenter
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.