CtrlK
BlogDocsLog inGet started
Tessl Logo

security

How to handle `GRIDA-SEC-<id>` security boundaries in the Grida repo. Triggers when you encounter a `GRIDA-SEC` tag in source/docs, when modifying files under any tagged path, or when adding a new prevented- vulnerability record. Each `GRIDA-SEC-<id>` identifies a structural trust boundary documented in `/SECURITY.md`. This skill explains the contract, mandates a security review before committing changes to any tagged file, and shows how to register a new id. Use whenever "GRIDA-SEC" appears in context.

73

Quality

91%

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

88%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 well-crafted procedural skill body: concrete commands, deterministic rules, and workflows with genuine validation gates ('do not commit' unless steps 1–4 pass). The residual gaps are minor — slight redundancy around the CVE contrast/exclusion rationale and content that is just past the length where splitting out a reference file would pay off.

DimensionReasoningScore

Conciseness

The body is lean and almost every token carries repo-specific information Claude cannot know (registry layout, id allocation, tag protocol). Minor over-explanation keeps it below anchor 5: the CVE contrast paragraph ('Unlike a CVE (which describes something that was once broken)') and the trailing 'good test' heuristic partly restate the point already made in 'When NOT to use this convention'. Not 3 because none of it is generic background knowledge.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: copy-paste-ready commands ('grep -rn GRIDA-SEC-<id> .' and the test-discovery grep with '--include=*test*'), a deterministic id-allocation rule ('find the highest existing GRIDA-SEC-NNN, use NNN+1'), and a prescribed four-section SECURITY.md entry shape with example tag formats ('// GRIDA-SEC-NNN: rule 2 — fail closed'). Not 4 because no key detail is left for the reader to fill in.

5 / 5

Workflow Clarity

Both multi-step processes are explicitly sequenced with validation checkpoints and a real feedback loop: the pre-commit review requires re-reading each SECURITY.md entry, walking each numbered enforcement step against the diff, verifying tags survive renames, and gating on 'If you cannot satisfy steps 1–4, do not commit. Either revert the change, or explicitly amend the SECURITY.md entry'. This matches the anchor 5 pattern of sequence + explicit validation + error-recovery path.

5 / 5

Progressive Disclosure

Sections are well-organized (meaning, working with tagged code, mandatory review, adding a new id, exclusions) and the body is appropriately self-contained for a convention skill with no bundle files. Below 5 because at ~95 lines the 'Adding a new id' procedure and the exclusions section are each substantial enough to live in a reference file, and the deep relative link ('../../../supabase/AGENTS.md#rpc-role-contract') is navigation a reader must resolve unaided. Not 3 because structure and signaling are otherwise clear and one level deep.

4 / 5

Total

18

/

20

Passed

Description

95%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: it states concrete capabilities, defines the contract artifact, and gives explicit, repeated trigger guidance keyed to a distinctive marker term. The only flaw is second-person phrasing ('you encounter', 'when modifying files under any tagged path') where third person is prescribed, costing one point on specificity.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'explains the contract, mandates a security review before committing changes to any tagged file, and shows how to register a new id' — with comprehensive coverage, which fits the anchor 5 example. Reduced by 1 per the judging guideline because it uses second-person voice ('Triggers when you encounter... when modifying files under any tagged path') instead of third person.

4 / 5

Completeness

Both questions are answered explicitly: 'what' is stated concretely (contract explanation, mandated pre-commit security review, id registration) and 'when' is given twice with concrete trigger phrases ('Triggers when you encounter a GRIDA-SEC tag in source/docs, when modifying files under any tagged path, or when adding a new prevented-vulnerability record'). This matches the anchor 5 example structure of what + 'Use when...' verbatim.

5 / 5

Trigger Term Quality

Natural trigger terms are comprehensively covered for the niche: 'GRIDA-SEC tag in source/docs', 'security boundaries', 'prevented-vulnerability record', '/SECURITY.md', and the closing 'Use whenever "GRIDA-SEC" appears in context' — a user touching this convention would say exactly these phrases. Not below 5 because no common synonyms within the domain are missing; the marker itself is the vocabulary.

5 / 5

Distinctiveness Conflict Risk

The trigger is a unique repo-specific marker ('GRIDA-SEC-<id>', '/SECURITY.md') rather than generic security language, giving it a clear niche with essentially zero overlap risk with other skills. Not 4 because no closely related skill could plausibly claim these triggers.

5 / 5

Total

19

/

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
gridaco/grida
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.