CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-settings-page

Add a new Sim settings page, or audit existing settings pages for design-system compliance with the shared SettingsPanel layout. Use when creating a settings tab, or when asked to check/clean up settings pages so they match the design system (consistent title, header, search, spacing).

70

Quality

88%

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.

An exemplary procedure-style skill body: lean, densely actionable, and every mode ends in an explicit verification step with diff-review feedback for batch changes. The only real gap is self-containedness — the canonical page shape, save/discard stack, and resource-row contract live entirely in an external rules file, so parts of Modes A and C are not executable from SKILL.md alone.

Suggestions

Inline a minimal skeleton of the canonical SettingsPanel page shape (actions/search/children/modal fragment) and the saveDiscardActions()/useSettingsUnsavedGuard wiring so Mode A is executable without opening the rules file.

Add a short props summary for SettingsResourceRow (trailing vs badge, navigable/clickLabel, bleed) or ship it as a skill reference file so the Mode C conversion has its contract at hand.

DimensionReasoningScore

Conciseness

Every line is a path, a copy-paste grep, a named API, or a decision rule (e.g. "A pixel-size fix swaps only the size class for its exact-pixel token (`text-[12px]` → `text-caption`)") — no explanation of concepts Claude already knows and no padding. Not 4 because nothing can be trimmed without losing operational content; the dense exception lists (exempt shells, non-heading title values) each earn their place.

5 / 5

Actionability

Gives copy-paste-ready commands with exact pathspecs (`git grep -n "flex h-full flex-col bg-\[var(--bg)\]" -- 'apps/sim/**/settings/**' 'apps/sim/ee/'`), named functions (`saveDiscardActions()`, `useSettingsUnsavedGuard`), and expected-match lists to judge output against. Not 5 because key shapes — the canonical page body, the save/discard wiring, and the resource-row contract — are deferred to `.claude/rules/sim-settings-pages.md` rather than shown, so Mode A steps 3–4 and the Mode C conversion aren't executable from this file alone; not 3 because everything actually written here is concrete and executable.

4 / 5

Workflow Clarity

Each mode is a numbered find→fix→verify sequence with explicit validation checkpoints, including for the batch sweep: "Verify the whole sweep: the local gate in the root CLAUDE.md, plus the affected pages' tests. Diff each file against the base and confirm the change is purely structural before shipping." Not 4 because no mode lacks a checkpoint — even Mode C's verify includes a per-block diff read for lost props, conditions, and key placement.

5 / 5

Progressive Disclosure

Clear mode-based sections and a "Key paths" map, with repeated, well-signaled one-level-deep pointers to the convention doc ("The full convention lives in `.claude/rules/sim-settings-pages.md` — read it first; this skill is the procedure"). Not 5 because the skill ships no bundle files and its completeness hinges on external repo rule files that cannot be verified from the bundle itself — a single moved path would silently hollow out Modes A–C; not 3 because structure and reference signaling are clear throughout with no nested-reference chains.

4 / 5

Total

18

/

20

Passed

Description

82%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: explicit what and when clauses, third-person imperative voice, natural trigger phrases, and a clearly bounded niche. The main weakness is incomplete capability coverage — two of the skill's three modes are represented but the SettingsResourceRow migration mode is omitted, capping specificity.

Suggestions

Add a third action clause covering Mode C, e.g. "or migrate hand-rolled list rows to the shared SettingsResourceRow component", so the description covers all three modes.

Add one or two natural trigger synonyms such as "settings section" or "new settings page" to broaden keyword coverage for the add mode.

DimensionReasoningScore

Specificity

"Add a new Sim settings page" and "audit existing settings pages for design-system compliance with the shared SettingsPanel layout" are two concrete, domain-specific actions, but coverage is not comprehensive — the row-migration capability (Mode C, `SettingsResourceRow`) is never mentioned. Not 4 because only two actions are listed rather than several; not 2 because the actions are concrete rather than generic.

3 / 5

Completeness

Explicitly answers both what ("Add a new Sim settings page, or audit existing settings pages for design-system compliance with the shared SettingsPanel layout") and when ("Use when creating a settings tab, or when asked to check/clean up settings pages so they match the design system") with concrete trigger phrases. Not 4 because the when clause is already explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural user phrasings are present — "creating a settings tab", "check/clean up settings pages", "match the design system", "consistent title, header, search, spacing" — giving good keyword coverage. Not 5 because common variations (e.g. "settings section", "new settings", migration/"resource row" triggers) are missing; not 3 because coverage includes multiple natural synonyms beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

"Sim settings page" and "shared SettingsPanel layout" pin a narrow, repo-specific niche with distinct triggers, so overlap with any other skill is minimal. Not 4 because no plausible overlap scenario exists — the triggers are unambiguous.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

simstudioai/sim

Path

.agents/skills/add-settings-page/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.