CtrlK
BlogDocsLog inGet started
Tessl Logo

ios-debugger-agent

Debug the current iOS project on a booted simulator with XcodeBuildMCP.

58

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/ios-debugger-agent/SKILL.md

The canonical home for this skill is ios-debugger-agent in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 well-crafted skill that provides concrete, tool-specific guidance for iOS simulator debugging via XcodeBuildMCP. Its strengths are high actionability with exact tool names and parameters, and a clear sequential workflow with validation steps. Minor improvements could be made in tightening a few verbose phrases and adding a more explicit debug feedback loop for log-based troubleshooting.

DimensionReasoningScore

Conciseness

The content is efficient and avoids explaining what simulators or iOS debugging are. Minor verbosity in the 'When to Use' section and some phrases like 'Follow this sequence unless the user asks for a narrower action' could be trimmed, but overall it respects Claude's intelligence.

4 / 5

Actionability

Every step names a specific MCP tool with exact parameters. The guidance is concrete and directly executable—tool names, parameter keys, and conditional logic are all spelled out. No pseudocode or vague instructions.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (discover → set defaults → build/run → interact → logs) with validation checkpoints like verifying app launch after build and checking build errors before UI interaction. Minor gap: no explicit feedback loop for log-based debugging (e.g., read logs → fix → rebuild → verify), though the troubleshooting section partially covers error recovery.

4 / 5

Progressive Disclosure

Content is well-organized into logical sections (Core Workflow, UI Interaction, Logs, Troubleshooting) with clear headers. For a skill of this size (~60 lines) with no bundle files, the structure is appropriate. It could benefit from separating the full tool reference into a companion file if the skill grows, but as-is the organization is solid.

4 / 5

Total

17

/

20

Passed

Description

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

The description is concise and identifies a specific tool and context (XcodeBuildMCP, iOS simulator debugging), but it lacks explicit trigger guidance ('Use when...') and could benefit from more natural user-facing keywords. It's functional but not comprehensive enough for reliable skill selection among many options.

Suggestions

Add a 'Use when...' clause with trigger phrases like 'run on simulator', 'test iOS app', 'launch app on iPhone simulator', or 'debug on device'

Include natural synonyms and variations users might say: 'run app', 'test on simulator', 'iPhone simulator', 'build and run'

Expand the capabilities described beyond just 'debug' - mention building, launching, attaching debugger, or viewing console output if applicable

DimensionReasoningScore

Specificity

Names the domain (iOS project debugging on simulator) and one concrete action (debug), but doesn't describe additional capabilities like setting breakpoints, viewing logs, or other debugging actions.

3 / 5

Completeness

Has a clear 'what' (debug iOS project on booted simulator) but lacks an explicit 'when' clause. There's no 'Use when...' guidance for Claude to know trigger conditions.

3 / 5

Trigger Term Quality

Includes relevant terms like 'iOS', 'simulator', 'debug', and 'XcodeBuildMCP', but misses natural variations users might say like 'run app', 'test on simulator', 'launch', 'iPhone simulator', or 'build and run'.

3 / 5

Distinctiveness Conflict Risk

Fairly distinct due to the specific mention of 'XcodeBuildMCP', 'iOS project', and 'booted simulator', which narrows the scope. Minor overlap risk with general iOS build or Xcode skills.

4 / 5

Total

13

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.