CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oss-standards

Pre-PR discipline for a public-by-default repo. What a reviewer enforces beyond CI: secrets and internal data in diffs or screenshots, docs that name their reader, and the cleaning pass where incomplete or confusing artifacts get dropped. Use before opening any PR against `gridaco/grida` or when finalizing work for review.

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

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 disciplined, well-structured policy skill: concrete patterns, remedies, and a literal decision procedure make it highly actionable, with external detail correctly delegated to sibling skills. The only slack is mild rhetorical restatement and a recap section that duplicate earlier material.

DimensionReasoningScore

Conciseness

The body assumes Claude's intelligence — no explanations of what a PR, secret, or screenshot is — and stays imperative with high signal density. It is not 5 because "The short version" section and some rhetorical restatement ("There is no internal channel; everything is the channel") could be trimmed; it is not 3 because there is no genuinely unnecessary explanation, only minor duplication.

4 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: concrete patterns to catch ("// TODO(me):", "~/scratch/...", "tmp.ts", "notes.md"), concrete remedies (".env.local (gitignored)", "draft: true", "split or rebase"), a literal per-file decision procedure ("Helps → keep / Recoverable question → fix / Unrecoverable question → drop"), and enumerated common removals. Specific examples cover the common cases, matching the top anchor; the 4 anchor's 'minor gaps' does not apply.

5 / 5

Workflow Clarity

The sequence is clear and ordered (security review runs first, the cleaning pass is "Final pass before opening the PR"), and the cleaning pass embeds an explicit per-file checkpoint ("If a stranger reads this file with no context, does it help them..."). It is not 5 because the overall flow is conveyed through section order rather than an explicit end-to-end sequence, leaving minor validation gaps; it is not 3 because the checkpoints (stranger question, security-first ordering, PR/commit message requirements) are explicit, and the destructive "drop" guidance is paired with its validation loop.

4 / 5

Progressive Disclosure

The file is well-organized into domain sections, and external material is delegated to one-level-deep, clearly signaled references ("[`links`](../links/SKILL.md)", "[`security`](../security/SKILL.md)", "[docs/AGENTS.md](../../../docs/AGENTS.md)") with a closing "See also" index. It is not 5 because there is no actual content split — everything lives in the single SKILL.md body — whereas the top anchor describes an overview with appropriately split content across files.

4 / 5

Total

17

/

20

Passed

Description

87%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 that explicitly states both what the skill enforces and when to use it, with concrete, repo-scoped triggers. Trigger-term coverage is good but could add spelled-out synonyms like "pull request" and "open source" for maximum recall.

DimensionReasoningScore

Specificity

The description names the domain ("Pre-PR discipline for a public-by-default repo") and lists several concrete enforcement actions ("secrets and internal data in diffs or screenshots, docs that name their reader, and the cleaning pass where incomplete or confusing artifacts get dropped"). It is not 3 because more than 1-2 concrete actions are named, and not 5 because some coverage is slightly metaphorical ("docs that name their reader") leaving minor gaps in comprehensiveness.

4 / 5

Completeness

Both halves are explicit: what it does ("What a reviewer enforces beyond CI: secrets and internal data in diffs or screenshots, docs that name their reader, and the cleaning pass where incomplete or confusing artifacts get dropped") and when to use it ("Use before opening any PR against `gridaco/grida` or when finalizing work for review"). The when clause contains concrete trigger phrases, matching the top anchor; the 4 anchor's 'when could be more explicit' does not apply here.

5 / 5

Trigger Term Quality

Natural trigger terms are present: "PR", "review", "secrets", "screenshots", "opening any PR", "finalizing work for review", plus the repo-scoped "gridaco/grida". It is not 5 because common synonyms such as "pull request" (spelled out) or "open source" are missing, though coverage is otherwise good.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — pre-PR review discipline specific to a public repo, anchored to a named repository — with distinct triggers. It is unlikely to fire for the wrong skill; the 4 anchor's 'minor overlap risk with closely related skills' does not apply given the repo-scoped framing.

5 / 5

Total

18

/

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

Warning

Total

15

/

16

Passed

Repository

gridaco/grida

Path

.agents/skills/oss-standards/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.