imsg-rpc

Set up, maintain, and debug the imsg-rpc Unix socket daemon that gives the gateway iMessage access via JSON-RPC. Covers FDA setup, code signing, launchd service, and the imsg source repo.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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.

A tightly written, highly actionable operational runbook with explicit validation checkpoints and feedback loops; its only gaps are minor command redundancy and an inlined protocol reference that could live in a separate file.

Suggestions

Extract the JSON-RPC Protocol Reference into a references/ file (e.g. references/protocol.md) and link to it from the body to improve progressive disclosure.

Consolidate the repeated 'cd ~/Code/steipete/imsg && ./build-local.sh' invocations by referencing the Rebuild imsg section from FDA Setup step 2 and the FDA-toggle troubleshooting entry.

Dimension	Reasoning	Score
Conciseness	Lean and assumes Claude's competence (no explanations of launchd, JSON-RPC, or SQLite), with only minor redundancy — build-local.sh is repeated across Rebuild, FDA Setup step 2, and the FDA-toggle troubleshooting entry.	4 / 5
Actionability	Fully executable, copy-paste-ready commands throughout (launchctl, sqlite3 TCC query, log show predicate, build-local.sh, open URL, keyboard shortcuts), with specific diagnostic commands per troubleshooting symptom.	5 / 5
Workflow Clarity	FDA setup is a clearly numbered 1-4 sequence with an explicit 'Verify:' checkpoint, and Troubleshooting provides error-recovery feedback loops (auth_value interpretation, 'If denied... If missing... redo step 3').	5 / 5
Progressive Disclosure	Well-organized into clearly headed sections with a Files table and an ADR pointer, but with no bundle files the JSON-RPC Protocol Reference is inlined rather than split into a one-level-deep reference file.	4 / 5
	Total	18 / 20 Passed

Description

75%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 specific, well-scoped description with concrete actions and low conflict risk, but it lacks an explicit 'Use when...' trigger clause and abbreviates 'Full Disk Access' as 'FDA', capping completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when setting up, restarting, or debugging iMessage gateway access on macOS.'

Spell out 'Full Disk Access (FDA)' so the natural term users would say is present alongside the abbreviation.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Set up, maintain, and debug') and enumerates four concrete sub-domains (FDA setup, code signing, launchd service, imsg source repo), giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Has a clear 'what' (set up/maintain/debug the imsg-rpc daemon) but no 'Use when...' clause or equivalent explicit trigger guidance, so per the cap completeness stays at 3.	3 / 5
Trigger Term Quality	Good natural-keyword coverage (iMessage, launchd, JSON-RPC, code signing, Unix socket), but uses the abbreviation 'FDA' rather than the more natural 'Full Disk Access' a user might actually say.	4 / 5
Distinctiveness Conflict Risk	Targets a highly specific niche (imsg-rpc Unix socket daemon, gateway iMessage access via JSON-RPC, launchd) with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	14 / 16 Passed

Repository: joelhooks/joelclaw
Path: skills/imsg-rpc/SKILL.md
Commit: 7094ced

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.