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).

67

Quality

81%

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

78%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 organizational skill body: it defines a crisp inclusion test, gives concrete grep-able markers and a complete naming map, sequences the work with an explicit security-review checkpoint, and keeps external detail one level deep. The residual weaknesses are minor — light rhetorical padding and no verification commands for the stated invariants.

DimensionReasoningScore

Conciseness

Efficient and competence-assuming — it never explains what a JWT, an OpenAI-compatible endpoint, or a grep is; every section (scoping test, marker, naming map, rules) carries load. A few rhetorical flourishes could be trimmed ("Treat every touch as work on a product that will one day live on its own", "The grep is the index", the closing blockquote), keeping it just below the lean-every-token-earns-its-place anchor.

4 / 5

Actionability

Concrete and executable: a copy-paste grep ("grep -rn 'GRIDA-GG' editor packages desktop"), exact marker comment forms for each surface, a complete identifier table, and a dual-marker example. Minor gaps: the dependency-direction rule ("The gateway must not import desktop/renderer code") states the invariant but gives no verification command, and the working rules reference paths without a check step.

4 / 5

Workflow Clarity

"Working on GG" is a clear 4-step sequence with rationale, and the security crossing has an explicit ordering checkpoint ("runs the `security` review **first** ... then this skill") plus a stated invariant. This is a code-organization skill, not a destructive/batch operation, so the missing validation/verification step (e.g. re-running the grep to confirm tagging) is a minor gap rather than a cap.

4 / 5

Progressive Disclosure

With no bundle files present, all content is appropriately inline in well-labeled sections; every outward reference is one level deep and clearly annotated with its role — canonical spec URL, SECURITY.md boundary, and each companion skill ("the GRIDA-SEC-006 half", "the credit ledger GG spends", "the two hosts"). Navigation is easy with a clean overview-to-detail flow.

5 / 5

Total

17

/

20

Passed

Description

83%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, dense description: it scopes a well-defined internal surface, enumerates its concrete components, gives explicit "use when" triggers, and pre-emptively disambiguates from companion skills. Its only weaknesses are component-oriented phrasing instead of action verbs and a few missing natural synonyms.

DimensionReasoningScore

Specificity

Enumerates several concrete components — "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" — giving comprehensive coverage of the surface, but describes the pattern's components rather than the actions performed (tagging, naming, placement), a minor gap versus the top anchor.

4 / 5

Completeness

Clearly answers both questions: the "what" is the enumerated four-surface working pattern for the metered no-BYOK gateway, and the "when" is explicit with concrete triggers — "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." Voice is third-person throughout.

5 / 5

Trigger Term Quality

Good keyword coverage of the terms a repo user would naturally say: "Grida Gateway (GG)", "GG file", "the `gg` provider kind", "the `gg:ai` token audience", "gateway surface", "no-BYOK", "org credit". A few natural variants (e.g. "hosted AI", "grida.gg") are absent, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct markers (`GRIDA-GG`, `gg:ai`, `gg` provider) and explicit delegation of the security half to the `security` skill, but the shared `GRIDA-SEC-006` boundary and the broad "deciding whether code belongs to the gateway surface" trigger leave minor overlap risk with the `security` and `ee-billing` companions — mostly distinct rather than minimal-conflict.

4 / 5

Total

17

/

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