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.
86
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description excels at specificity and distinctiveness, clearly identifying a narrow technical domain with concrete actions. However, it lacks explicit trigger guidance ('Use when...') and relies on technical jargon that users may not naturally use when seeking help, which could reduce discoverability.
Suggestions
Add a 'Use when...' clause with trigger scenarios like 'Use when troubleshooting iMessage integration, socket connection failures, or launchd service issues'
Expand the acronym 'FDA' (Full Disk Access) and include more natural user phrases like 'iMessage not sending', 'daemon not starting', or 'permission errors'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Set up, maintain, and debug' the daemon, plus covers specific technical areas: 'FDA setup, code signing, launchd service, and the imsg source repo.' | 3 / 3 |
Completeness | Clearly answers 'what' (set up, maintain, debug the daemon with specific technical areas), but lacks an explicit 'Use when...' clause or equivalent trigger guidance for when Claude should select this skill. | 2 / 3 |
Trigger Term Quality | Includes some relevant technical terms like 'imsg-rpc', 'Unix socket daemon', 'JSON-RPC', 'launchd', 'iMessage', but uses jargon like 'FDA' without expansion and misses common user phrases like 'message service not working' or 'socket connection issues'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly specific niche targeting 'imsg-rpc Unix socket daemon' for iMessage gateway access - this is unlikely to conflict with other skills due to the very specific technology stack mentioned. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill document. It provides comprehensive, actionable guidance for a complex system involving code signing, launchd services, and FDA permissions while remaining extremely concise. The troubleshooting section is particularly strong with specific diagnostic commands and clear remediation steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what launchd, FDA, or Unix sockets are. Every section provides only the commands and paths needed, assuming Claude understands the underlying concepts. | 3 / 3 |
Actionability | Fully executable commands throughout. The FDA setup provides complete, copy-paste ready certificate generation, the status checks are specific one-liners, and troubleshooting includes exact sqlite3 queries and log commands. | 3 / 3 |
Workflow Clarity | Multi-step processes (FDA setup, troubleshooting) are clearly numbered with explicit validation checkpoints. The FDA setup has a verification step ('should show imsg Local Signing'), and troubleshooting includes clear diagnostic → fix → verify patterns. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections (Architecture, Status Check, Rebuild, FDA Setup, Troubleshooting, Protocol Reference, Files). References to external files (ADR, source repo, gateway channel) are one level deep and clearly signaled in the Files table. | 3 / 3 |
Total | 12 / 12 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- 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.