CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gg

Work on Grida's Gateway product consumer, scoped native AI tokens, installed gg provider and Desktop integration. Use for product execution adapters, not standalone Gateway service implementation or billing policy.

55

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/gg/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 an exemplary lean constraint list — zero padding, all repo-specific invariants — but it instructs through rules and pointers rather than executable steps. Its implicit workflow and absent runnable commands keep actionability and workflow clarity at mid-scale despite the excellent token efficiency.

Suggestions

Add the concrete commands for the verification lanes (e.g., the exact test-runner invocation for the 'focused no-dotenv unit/API tests' and the paired SDK lane fixture setup) so the guidance is executable rather than descriptive.

Make the implicit workflow explicit and sequenced: read the adapter and referenced docs → apply the constraints → run the unit tests → only then run the SDK lane with the local fixture, with an explicit checkpoint that failures must be fixed before proceeding.

Clarify or make robust the relative links (`../platform-consumers/SKILL.md`, `../../../SECURITY.md`) — they do not resolve from the skill directory as bundled, so state the repo-root-relative path or copy the needed `GRIDA-SEC-006` content into a local reference file.

DimensionReasoningScore

Conciseness

The ~26-line body is dense with project-specific invariants Claude could not know otherwise ('Account tokens, scoped native tokens and product workload credentials are distinct', 'Download failure must not resubmit paid work') and assumes full competence — no generic concepts are explained and every token earns its place. It matches the 'lean and efficient; assumes Claude's competence' anchor exactly, so 4 or lower would be unjustified.

5 / 5

Actionability

Concrete anchors exist — specific paths (`editor/lib/ai/`), named references (`GRIDA-SEC-006`, `../platform-consumers/SKILL.md`), a named audience (`gg:ai` native audience), and test constraints ('focused no-dotenv unit/API tests and editor TypeScript') — but there is no executable artifact: no commands to run, no test invocation, no example DTO or token shape. This matches 'some concrete guidance but incomplete; missing key details'; it is not 4 because nothing in the body is copy-paste runnable, and not 2 because the named files, markers, and constraints are specific enough to act on.

3 / 5

Workflow Clarity

A rough sequence is implicit — read the referenced adapter and docs, apply the constraints, verify with unit tests and the fixture-based SDK lane — but it is never laid out as steps, and the test guidance is stated as a rule ('Use focused no-dotenv unit/API tests') rather than a validation checkpoint with an error-recovery path. That matches 'sequence present but checkpoints missing or implicit'; no destructive/batch cap applies, and it is not 4 because the verify step is not integrated into any explicit ordering.

3 / 5

Progressive Disclosure

The short body appropriately stays an overview and its pointers are one level deep and clearly signaled (named section `GRIDA-SEC-006` in a linked SECURITY.md, a sibling skill link, and the public contract URL). It is not 5 because there are no section headers separating context, constraints, and verification, and the relative links (`../platform-consumers/SKILL.md`, `../../../SECURITY.md`) do not resolve from the skill's own directory — they depend on repo layout, and no local bundle files exist to back them.

4 / 5

Total

15

/

20

Passed

Description

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

The description carves out a precise, well-bounded niche with explicit in/out-of-scope guidance, but it tells the model what area it covers rather than what it does. Generic verb choice ('Work on') and jargon-level trigger phrasing leave it noticeably below the strong examples on specificity and natural trigger quality.

Suggestions

Replace the generic verb 'Work on' with concrete actions, e.g., 'Implement and maintain consumer adapters for Grida Gateway generation, handle scoped `gg:ai` native tokens, and persist product results in editor/lib/ai/ and Desktop integration code.'

Add natural trigger phrases users would actually say, e.g., 'Use when touching `editor/lib/ai/` adapters, the installed `gg` provider, `gg:ai` scoped tokens, or Grida Gateway consumer/Desktop code.'

Include a concrete file-path or component trigger (such as `editor/lib/ai/` or `GRIDA-GG:` code markers) so the description fires on repository cues, not only on product-level jargon.

DimensionReasoningScore

Specificity

The description names the domain ("product consumer, scoped native AI tokens, installed gg provider and Desktop integration") but the only verb is the generic "Work on" — it lists areas rather than concrete actions, matching the 'names the domain but actions are minimal or generic' anchor. It does not reach 3 because no specific action (implement adapters, persist results, migrate consumers) is stated; it is not 1 because the domain nouns are concrete and narrowly scoped.

2 / 5

Completeness

Both parts are present: the 'what' is the scoped consumer/token/provider/Desktop surface, and an explicit trigger clause exists — "Use for product execution adapters, not standalone Gateway service implementation or billing policy" — which also delineates the negative boundary. It does not reach 5 because the 'when' is abstract ('product execution adapters' rather than concrete trigger phrases like 'touching editor/lib/ai/ or the gg provider'), and it is above 3 because explicit 'Use for' guidance is present rather than merely implied.

4 / 5

Trigger Term Quality

Relevant domain keywords are present ("Grida's Gateway", "gg provider", "Desktop integration", "product execution adapters") that a user on this codebase would plausibly say, but there are no natural variations, synonyms, or file-path triggers (e.g., `editor/lib/ai/`, `gg:ai`), matching 'some relevant keywords but missing common variations or synonyms'. It is above 2 because several genuinely project-specific terms appear, and below 4 because the phrasing stays at the jargon level rather than the phrases a user would naturally type.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and product-specific with an explicit exclusion ("not standalone Gateway service implementation or billing policy"), which strongly disambiguates from a neighboring Gateway-service or billing skill. It stays at 4 rather than 5 because the shared trigger terms ("Grida Gateway", tokens, provider) still create minor overlap risk with that closely related service-side skill — the disambiguation relies on the reader parsing the negative clause.

4 / 5

Total

13

/

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 suspicious

Warning

Total

15

/

16

Passed

Repository

gridaco/grida

Path

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