CtrlK
BlogDocsLog inGet started
Tessl Logo

github-issues

GitHub issue comment guidelines for community interaction. Use when: "respond to this issue", "reply to this bug report", "close this issue", or any GitHub discussion.

66

Quality

83%

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

82%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 strong instruction-only skill: it supplies exact phrases, ordered comment structures, and complete example responses instead of abstract advice, with no padding explaining concepts Claude already knows. The only real improvement areas are minor redundancy around gratitude/closing guidance and the option to move full response templates into a reference file.

DimensionReasoningScore

Conciseness

The body is directive and assumes Claude's competence — it gives rules, exact phrases, and compact templates instead of explaining what GitHub or commenting is. Minor redundancy keeps it from level 5: gratitude/closing guidance is repeated across 'Fixed Issues', 'Closing', and the example templates, and 'Anti-Patterns' partially restates the compression rule.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready for an instruction-only skill: exact opening lines ("Hey @username, thank you for the issue"), a fixed 4-part comment shape, complete example responses for the common cases (fixed issue, debugging offer, quick acknowledgment, PR back-and-forth), and specific links (cal.com, Discord). This matches the level 5 anchor of specific examples covering the common cases.

5 / 5

Workflow Clarity

A clear composition workflow is present: the pre-draft question ('what does the reader need to know or do next?'), the 4-step comment shape, and the explicit ordering for fixed issues (thank → state → version only if it helps verify → close). It sits at level 4 rather than 5 because the guidance is spread across several overlapping sections (Anti-Patterns, Respect Gate, Core Elements, Style Notes) without a single consolidated checklist, though for a non-destructive writing skill no validation cap applies.

4 / 5

Progressive Disclosure

Sections are well-organized and navigable, and the one external reference (writing-voice for tone) is clearly signaled and one level deep. The four full response examples (~40 lines) could arguably live in a separate references file to keep SKILL.md a leaner overview, which is what keeps this at level 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

78%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 well-formed description with an explicit 'Use when' clause and natural, quotable trigger phrases. Its main weakness is that the 'what' is a single generic phrase ('comment guidelines') rather than a list of concrete capabilities, and the trailing 'any GitHub discussion' broadens the niche slightly.

Suggestions

Replace the generic 'comment guidelines' phrase with 2-3 concrete capabilities, e.g., 'Draft, reply to, and close GitHub issue comments with acknowledgments, fix announcements, and clarifying questions.'

Narrow or split the catch-all 'any GitHub discussion' trigger to reduce overlap with PR-review skills, e.g., add 'comment on this PR' as an explicit trigger if PR comments are in scope.

Add missing natural trigger variations such as 'triage this issue' or 'follow up on this issue' to round out keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain clearly ("GitHub issue comment guidelines for community interaction") but the stated action is generic — it says the skill provides 'guidelines' rather than listing concrete capabilities (e.g., drafting replies, closing issues, requesting repro details). It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' more than the vague level 2 because the interaction purpose is stated, but it does not reach level 4's 'several specific actions'.

3 / 5

Completeness

It explicitly answers both what ("GitHub issue comment guidelines for community interaction") and when ("Use when: 'respond to this issue', 'reply to this bug report', 'close this issue', or any GitHub discussion") with concrete trigger phrases — a clear match for the level 5 anchor. Level 4 would require the 'when' to be less explicit than it is here.

5 / 5

Trigger Term Quality

The 'Use when' clause gives natural quoted phrases users would actually say — "respond to this issue", "reply to this bug report", "close this issue" — plus "any GitHub discussion". Coverage is good but misses common variations like PR comments, 'triage this issue', or 'follow up on this issue', so it falls just short of the comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

The GitHub issue/comment niche is distinct with specific triggers, but the catch-all "or any GitHub discussion" is broad and could overlap with PR-review or general GitHub workflow skills. Mostly distinct with minor overlap risk — the level 4 anchor — rather than level 5's 'minimal conflict risk'.

4 / 5

Total

16

/

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: 2 missing, 1 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.