CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-permission-group-item

Add a new governed item to Sim's enterprise permission groups — a boolean restriction, an allowlist, or a denylist — wired end-to-end from the field registry through the capability rule to the server gate that actually refuses. Use when adding a key to `PERMISSION_GROUP_FIELDS` or a capability to `CAPABILITY_RULES`.

68

Quality

86%

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

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

This is a highly actionable, well-sequenced procedure with excellent validation and error-recovery guidance, all grounded in codebase-specific invariants rather than generic explanation. Its weaknesses are verbosity in the ornate justificatory prose and the total absence of progressive disclosure — a ~270-line monolith with no reference files for auxiliary material like the traps and principal tables.

Suggestions

Move the auxiliary material — the 'Traps' catalog and the 'Surfaces that do not go through the funnel' principal tables — into one-level-deep reference files (e.g., references/traps.md, references/surfaces.md), keeping SKILL.md as the step procedure with clearly signaled pointers.

Tighten the longest justificatory passages (e.g., the `allowedIntegrations` enforcement paragraph and the executor-row rationale) to declarative invariants; the rationale can often be one clause instead of a multi-sentence narrative.

Trim the closing checklist to items not already enforced by the step text, or fold each checklist line into its corresponding step to remove the restatement.

DimensionReasoningScore

Conciseness

The ~270-line body contains no filler about concepts Claude already knows — nearly every sentence is repo-specific invariant — but the prose is ornate (long multi-clause justifications such as the `allowedIntegrations` enforcement paragraph) and the closing checklist restates the step sections, so it could be noticeably tightened. It is above 2 because the density is load-bearing rather than padded, and below 4 because the trimming opportunities are more than minor.

3 / 5

Actionability

The skill supplies copy-paste-ready snippets for each concrete case (field entry, capability rule, `defineWorkspaceOperation`, the `// permission-group-enforced:` call-site annotation, the parameterized wrapper) plus exact helper names, file paths, and runnable `bun run check:*` commands. This matches the top anchor of fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced, and Step 7 provides explicit validation: the three audit commands, reading success lines rather than exit codes, comparing counts against the previous run, and error-recovery direction ('if a self-check fires, teach the parsers the new form rather than working around it'), capped by a pre-finish checklist. Feedback loops and checkpoints are all present, matching the top anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything — including auxiliary material like the principal/identity tables and the traps catalog that could live in one-level-deep reference files — is inlined in a single long SKILL.md. Section headers do give genuine structure, matching the 3 anchor ('some structure ... content that should be separate is inline'), but it is not a 4 because no content is split out or referenced and the file reads as a monolith beyond a single procedure's needs.

3 / 5

Total

16

/

20

Passed

Description

92%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 in third-person imperative form, includes an explicit 'Use when' clause with precise code-identifier triggers, and occupies an unambiguous niche. The only weakness is slightly narrow trigger vocabulary that relies on the two registry names rather than broader natural phrasings.

Suggestions

Broaden the 'Use when' clause with one or two natural phrasings users might say, e.g., 'Use when restricting or withholding a feature for a permission group cohort, adding a key to `PERMISSION_GROUP_FIELDS`, or adding a capability to `CAPABILITY_RULES`.'

DimensionReasoningScore

Specificity

The description names the three concrete artifact kinds ("a boolean restriction, an allowlist, or a denylist") and the full wiring path ("from the field registry through the capability rule to the server gate that actually refuses"), giving comprehensive, concrete coverage of what the skill produces. It is not a 4 because no coverage gaps are evident within its stated domain.

5 / 5

Completeness

Both halves are explicit: the what ("Add a new governed item ... wired end-to-end from the field registry through the capability rule to the server gate") and the when ("Use when adding a key to `PERMISSION_GROUP_FIELDS` or a capability to `CAPABILITY_RULES`") with concrete trigger phrases. This matches the top anchor exactly; a 4 would require a less explicit or specific when-clause.

5 / 5

Trigger Term Quality

Triggers include natural domain terms ("permission groups", "restriction", "allowlist", "denylist") plus the exact code identifiers `PERMISSION_GROUP_FIELDS` and `CAPABILITY_RULES`, which fire reliably in this codebase. It falls short of 5 because common synonyms and phrasings a user might naturally say (e.g., "gating a feature", "withholding access", "restriction key") are absent.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche ("Sim's enterprise permission groups") anchored by codebase-specific registry names, so it is highly unlikely to trigger for the wrong skill. It is above the 4 anchor because no overlap with closely related skills is identifiable.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

simstudioai/sim

Path

.agents/skills/add-permission-group-item/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.