CtrlK
BlogDocsLog inGet started
Tessl Logo

gg

Working pattern for Grida Gateway (GG) — Grida's first-party, metered, no-BYOK AI surface: the scoped-token mint, the OpenAI-compatible + native gateway endpoints, the `gg` client provider, and the desktop wiring that spends org credit without a user key. Anchor for the `GRIDA-GG: <surface>` grep marker; its security half is `GRIDA-SEC-006`. Use when adding or touching any GG file, the `gg` provider kind, the `gg:ai` token audience, or deciding whether code belongs to the gateway surface. Companions: `security` (the GRIDA-SEC-006 half), `ee-billing` (the ledger it spends), `agent-system` and `desktop` (the two hosts).

74

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

A tight, well-organized organizational skill: concrete identifiers and grep commands, an explicit decision test, a clear working sequence, and well-signaled cross-references. It assumes Claude's competence throughout and wastes no tokens on background explanation.

DimensionReasoningScore

Conciseness

Dense, information-rich prose that assumes competence (no explaining what a JWT, gateway, or BYOK is); every section — the surface test, naming map, marker rules — earns its place with no padding.

3 / 3

Actionability

Gives concrete, copy-paste-ready guidance: the exact grep `grep -rn 'GRIDA-GG' editor packages desktop`, exact marker comment formats, and an identifier-by-identifier naming table — actionable for a code-organization skill.

3 / 3

Workflow Clarity

The numbered 'Working on GG' sequence and the 'When GG crosses security' precedence (run the security skill first, then this pass) give a clear ordered process with an explicit checkpoint; no destructive batch step is present that would require a validation loop.

3 / 3

Progressive Disclosure

No bundle files exist; the body is self-contained and well-organized into clearly signaled sections with one-level-deep cross-references to companion skills (../security/SKILL.md, ../ee-billing/SKILL.md), satisfying the simple-skill allowance.

3 / 3

Total

12

/

12

Passed

Description

85%

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 precise, well-structured description that covers what and when explicitly and carves out a distinct niche. Its only weakness is trigger phrasing: the terms are internal codebase identifiers that a user would rarely voice naturally.

Suggestions

Add one or two natural-language trigger phrases a developer might actually say (e.g. 'Use when wiring up keyless/Grida-billed AI calls' or 'when the user asks about the gg provider or hosted-ai billing') alongside the identifier-based triggers.

Surface a plain-language alias for 'GG' early so a user searching for 'hosted AI' or 'Grida gateway' lands here.

DimensionReasoningScore

Specificity

Lists multiple concrete surfaces — 'the scoped-token mint, the OpenAI-compatible + native gateway endpoints, the `gg` client provider, and the desktop wiring' — matching the multi-action anchor.

3 / 3

Completeness

Explicitly answers what (the GG working pattern and its four surfaces) and when ('Use when adding or touching any GG file, the `gg` provider kind, the `gg:ai` token audience, or deciding whether code belongs to the gateway surface').

3 / 3

Trigger Term Quality

The 'Use when adding or touching any GG file, the `gg` provider kind, the `gg:ai` token audience' clause gives explicit triggers, but the terms are internal code identifiers/jargon rather than phrases a user would naturally say, and common variations are thin.

2 / 3

Distinctiveness Conflict Risk

A clearly scoped internal niche (Grida Gateway surface) with a unique grep marker, named companions, and explicit carve-outs ('Not GG: the billing ledger...'), so it is unlikely to trigger for the wrong skill.

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: 8 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.