Agent skill

Inspector Integration

by ipedro in ipedro/Inspector

A skill your agent uses when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and…

MITAuto-check passedMobile

Install Inspector Integration

skills CLI
$ npx skills add ipedro/Inspector --skill inspector-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ipedro/Inspector inspector-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ipedro/Inspector.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Plugins/inspector-mcp/skills/inspector-integration .claude/skills/inspector-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
inspector-integration
GitHub stars
170
Token cost
~724 tokens
SKILL.md length
272 words
Files
2 (incl. references)
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and…

  • An agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring
  • SKILL.md covers Overview, Core startup pattern, Typical integration tasks and Common entry points, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Configuration/customization

What it does

Inspector Integration is an agent skill from ipedro/Inspector. Use when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and custom panel registration. Especially useful when patching another iOS app to call Inspector.start() correctly and optionally register custom Inspector libraries.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/integration-patterns.md`).

It sits in Mobile, covering iOS development. It works with iOS, Model Context Protocol and SwiftUI. The repository describes itself as: Inspector is a debugging library written in Swift. The licence is MIT.

When your agent uses it

  • An agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring
  • Configuration/customization
  • Debug-only gating
  • Custom panel registration

Example prompts

  • “/inspector-integration”

What it can do on your machine

Read from SKILL.md and the folder at commit bb220e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are swift).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Inspector Integration loads about 724 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 272 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~724
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ipedro/Inspector at commit bb220e4, republished under its MIT licence (© ipedro). 272 words, ~724 tokens.

Download SKILL.mdSave it as .claude/skills/inspector-integration/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
inspector-integration
description
Use when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and custom panel registration. Especially useful when patching another iOS app to call `Inspector.start()` correctly and optionally register custom Inspector libraries.

Inspector Integration

Overview

Use this skill when integrating Inspector the library into a consumer app. This is broader than MCP bridge setup and applies even when the app only needs:

  • Inspector.start() / Inspector.stop()
  • configuration via InspectorConfiguration
  • customization via InspectorCustomizationProviding
  • debug-only custom panels/libraries/macros
  • InspectorInterface macro adoption (@InspectorPanel, @InspectorProperty)

Core startup pattern

The safe baseline is:

swift
Inspector.setConfiguration(...)
Inspector.setCustomization(...)
Inspector.start()

Do configuration/customization before Inspector.start().

Typical integration tasks

  • add Inspector startup to UIKit or SwiftUI app entry points
  • keep startup debug-only
  • register custom libraries/panels through InspectorCustomizationProviding
  • integrate InspectorInterface macros cleanly in a consumer app
  • verify Example-like integration patterns in another app
  • preserve existing app startup behavior while inserting Inspector cleanly

Common entry points

  • UIKit lifecycle: SceneDelegate.scene(_:willConnectTo:)
  • older UIKit lifecycle: AppDelegate
  • SwiftUI lifecycle: @main App / app delegate adaptor or debug bootstrap path

Debug-only guidance

Prefer keeping Inspector setup in debug-only code paths so release builds stay clean. If the consumer app uses macro-based custom panels, ensure the same debug trait/build gating applies consistently.

Macro integration guidance

When the consumer app uses @InspectorPanel / @InspectorProperty:

  • import InspectorInterface for the macro declarations
  • import Inspector when the file also uses Inspector runtime APIs directly (Inspector.start(), customization types, etc.)
  • do not hide @InspectorProperty from the macro expander with local #if guards around the annotation itself unless you are certain the macro still sees the declaration
  • prefer gating the surrounding integration/bootstrap path rather than making the annotation invisible

The generated code references Inspector runtime symbols, so the consumer target must have the proper Inspector package products linked in its debug configuration.

Verification

  • app launches with Inspector enabled
  • no duplicate Inspector.start() calls
  • configuration/customization are applied before startup
  • custom panels/libraries appear when expected

References

Read only when needed:

  • references/integration-patterns.md

© ipedro, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in Plugins/inspector-mcp/skills/inspector-integration of ipedro/Inspector.

  • SKILL.md
  • references/integration-patterns.md

Open the folder on GitHubat commit bb220e4

Compare with similar skills

Inspector Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Inspector Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Inspector Integration this skillipedro/Inspector170—~724Automated safety check: PassMIT
Update Swiftui APIsAvdLee/SwiftUI-Agent-Skill3.7k—~1.2kAutomated safety check: PassMIT
Pp Apple Docsmvanhorn/printing-press-library2.1k—~3.7kAutomated safety check: NotesApache-2.0
Swiftui Expert SkillAvdLee/SwiftUI-Agent-Skill3.7k—~2.9kAutomated safety check: PassMIT
Swiftui Expert SkillEslzzyl/Pixiv-SwiftUI1115 repos~3.1kAutomated safety check: PassAGPL-3.0
Swiftui Liquid Glassharperreed/dotfiles3348 repos~941Automated safety check: PassNone

Similar skills

  • Update Swiftui APIs

    AvdLee/SwiftUI-Agent-Skill

    Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

    3.7k GitHub stars~1.2k tokensUpdated yesterday
    MobileAuto-check passed
  • Pp Apple Docs

    mvanhorn/printing-press-library

    Every Apple framework, indexed locally, with deprecation analysis and an MCP server no other Apple-docs tool has.

    2.1k GitHub stars~3.7k tokensUpdated yesterday
    MobileAuto-check: notes
  • Swiftui Expert Skill

    AvdLee/SwiftUI-Agent-Skill

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and @Observable data flow, view composition, resizable layouts, safe areas, display…

    3.7k GitHub stars~2.9k tokensUpdated yesterday
    MobileAuto-check passed
  • Swiftui Expert Skill

    Eslzzyl/Pixiv-SwiftUI

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management and @Observable data flow, view composition and invalidation/performance…

    111 GitHub starsUsed in 5 repos~3.1k tokens
    MobileAuto-check passed
  • Swiftui Liquid Glass

    harperreed/dotfiles

    Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API.

    334 GitHub starsUsed in 8 repos~941 tokens
    MobileAuto-check passed
  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    142 GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed

More from ipedro/Inspector

  • Inspector MCP

    ipedro/Inspector

    A skill your agent uses when an agent needs to inspect a live iOS app through the Inspector MCP bridge, register or troubleshoot InspectorMCPServer for a consumer Xcode project, or query, resolve…

    170 GitHub stars~3.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Inspector Implementation

    ipedro/Inspector

    A skill your agent uses when an agent needs to implement or modify the Inspector library itself — panel UI, hierarchy/runtime behavior, custom property models, macros, or Example-app dogfooding.

    170 GitHub stars~729 tokensUpdated 5 mo ago
    Auto-check passed
  • Inspector MCP Consumer

    ipedro/Inspector

    A skill your agent uses when an agent needs to patch a consumer iOS app so it exposes the Inspector MCP bridge, add or verify the app-side Inspector startup configuration, or choose the correct…

    170 GitHub stars~926 tokensUpdated 5 mo ago
    Auto-check passed

Categories

Questions about Inspector Integration

What does Inspector Integration do?

A skill your agent uses when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and…. Inspector Integration is an agent skill from ipedro/Inspector. Use when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and custom panel registration.

When should I use Inspector Integration?

Inspector Integration fits situations like: an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring; configuration/customization; debug-only gating; custom panel registration.

How do I install Inspector Integration in Claude Code?

Run `npx skills add ipedro/Inspector --skill inspector-integration -a claude-code`. Or copy the skill folder (Plugins/inspector-mcp/skills/inspector-integration in ipedro/Inspector) into .claude/skills/inspector-integration in your project. Claude Code loads it when a task matches its description.

How do I install Inspector Integration in Codex?

Run `npx skills add ipedro/Inspector --skill inspector-integration -a codex`. Or copy the skill folder (Plugins/inspector-mcp/skills/inspector-integration in ipedro/Inspector) into .agents/skills/inspector-integration in your project. Codex loads it when a task matches its description.

Can I use Inspector Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ipedro/Inspector --skill inspector-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/inspector-integration, .gemini/skills/inspector-integration, .github/skills/inspector-integration and .opencode/skills/inspector-integration in your project.

What does Inspector Integration need to run?

SKILL.md names no scripts, command-line tools or credentials: Inspector Integration is instructions for the agent only.

Does Inspector Integration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Inspector Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Inspector Integration use?

Inspector Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Inspector Integration use?

About 724 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 365 tokens, read only when the agent opens those files.

What are the alternatives to Inspector Integration?

Skills that share tags, products or a category with Inspector Integration: Update Swiftui APIs (AvdLee/SwiftUI-Agent-Skill, 3.7k stars), Pp Apple Docs (mvanhorn/printing-press-library, 2.1k stars), Swiftui Expert Skill (AvdLee/SwiftUI-Agent-Skill, 3.7k stars) and Swiftui Expert Skill (Eslzzyl/Pixiv-SwiftUI, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Inspector Integration?

ipedro (a GitHub user) maintains it in ipedro/Inspector, which has 170 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on April 19, 2026.

Source: ipedro/Inspector on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.