Content
61%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with concrete CLI commands, real flags, and a useful action table, plus a well-structured connection workflow with state-based checkpoints. The main gaps are mild verbosity in framing prose, destructive actions lacking validation guidance, and the large action table being inline rather than offloaded to a reference file.
Suggestions
Trim framing prose that Claude does not need (the 'Real estate professionals use it to...' sentence and the 'so you can focus on the integration logic' aside) to tighten token efficiency.
Add a validation/confirmation checkpoint before destructive actions (e.g., 'Before running delete-subscriber, confirm the subscriber ID with the user and verify via get-subscriber') to lift the workflow-clarity cap.
Consider moving the full popular-actions table into a references file (e.g., ACTIONS.md) and keeping only the most common few inline, with a clearly signaled link.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes unnecessary asides Claude does not need (e.g., 'Real estate professionals use it to generate leads, showcase listings...' and 'so you can focus on the integration logic rather than auth plumbing'), fitting the 3-anchor for mostly efficient content that could be tightened rather than the lean 4-anchor. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready commands with real flags throughout (login, connection ensure, action list/run, request) and a popular-actions table with keys, but several commands retain unfilled placeholders (CONNECTION_ID, <id>, <actionId>) requiring substitution, fitting the 4-anchor for mostly executable guidance with minor gaps rather than fully turnkey 5. | 4 / 5 |
Workflow Clarity | The connection workflow has a clear sequence with explicit state checkpoints and a polling feedback loop (READY/BUILDING/CLIENT_ACTION_REQUIRED), but the skill exposes destructive operations (delete-subscriber) in the action table with no validation or confirmation guidance before running them, which caps workflow clarity at 3 per the destructive-operation guideline. | 3 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clear sections (Overview, Working with IHomefinder, Popular actions, Best practices) with no nested references and no bundle files, but the large 20-row popular-actions table is inline content that could arguably live in a separate reference file, fitting the 4-anchor for good structure with minor organization gaps rather than the ideal split 5-anchor. | 4 / 5 |
Total | 14 / 20 Passed |