CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-settings-audit

Analyze a repository to generate recommended Claude Code settings.json permissions. Use when setting up a new project, auditing existing settings, or determining which read-only bash commands to allow. Detects tech stack, build tools, and monorepo structure.

Quality

85%

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

82%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 highly actionable, well-structured instruction skill: exact commands, complete permission lists, detection mappings, and explicit include/exclude rules. Its weaknesses are modest — some redundancy between the stack-specific tables and the later rules tables, and inline content (Sentry skill list, MCP details) that could be split into reference files.

DimensionReasoningScore

Conciseness

The body is dense and lean — detection tables and exact permission strings rather than concept explanations — and assumes Claude's competence throughout. Minor redundancy keeps it below the top anchor: the 'Package Manager Rules' table largely restates the stack-specific command tables and the 'What to NEVER Include' section repeats earlier guidance ('Alternative package managers' vs. the same rule in Phase 4).

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: a concrete detection command ('find . -maxdepth 2 ...'), complete baseline allow list with exact permission strings ('Bash(ls:*)', 'Bash(gh pr view:*)'), detection-to-command mapping tables, complete MCP JSON blocks with placeholders, and a structured output format with example. The common cases (Python/Node/other languages, existing settings, merge instructions) are all concretely covered.

5 / 5

Workflow Clarity

The four phases are clearly sequenced (detect stack → detect services → check existing settings → generate recommendations) with conditional logic ('Only include commands for tools actually detected') and merge instructions for the existing-settings case. It is not a destructive or batch operation, so heavy validation loops are unneeded, but minor checkpoints are absent — e.g., no step verifying the generated JSON is valid or confirming detected stack before recommending — fitting 'clear sequence with most checkpoints; minor validation gaps' rather than the fully validated anchor.

4 / 5

Progressive Disclosure

The body is well organized with clear section headers (Phase 1–4, Important Rules, Output Format) and navigable tables, and there are no bundle files, so everything must live inline. Minor gaps: the 25-entry sentry-skills list and the framework-specific WebFetch/MCP sections are candidate material for separate reference files, and the escaped nested code fences in the output example are slightly awkward, keeping it just below the top anchor.

4 / 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 description: concrete, third-person, with an explicit and well-phrased 'Use when...' trigger clause covering three realistic scenarios. The only notable gaps are unmentioned deliverables (MCP suggestions, WebFetch domains) and a few missing synonyms like 'allowlist'.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Analyze a repository to generate recommended Claude Code settings.json permissions' and 'Detects tech stack, build tools, and monorepo structure' — but omits portions of the skill's actual output such as WebFetch domain allowlists and MCP server suggestions, a minor coverage gap. It is above the midpoint (multiple specific actions) but not fully comprehensive, so it fits the 'several specific actions; minor gaps' anchor rather than the comprehensive anchor.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ('Analyze a repository to generate recommended Claude Code settings.json permissions... Detects tech stack, build tools, and monorepo structure') and the 'when' ('Use when setting up a new project, auditing existing settings, or determining which read-only bash commands to allow'). Both are concrete and explicit, matching the top anchor; a lower score would require a weaker or implied 'when', which is not the case.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'setting up a new project', 'auditing existing settings', 'determining which read-only bash commands to allow', plus 'settings.json permissions', 'tech stack', and 'monorepo'. Coverage is good but misses common synonyms like 'allowlist', 'allow list', or 'permission setup', placing it just below comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche (Claude Code settings.json permission auditing/generation) is well-defined with distinct triggers around 'settings.json permissions' and 'read-only bash commands'. Minor overlap risk exists with closely related permission/allowlist skills, so it fits 'mostly distinct; minor overlap risk' rather than 'clear niche with minimal conflict risk'.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/claude-settings-audit/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.