Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides strong actionable guidance with executable CLI commands and a well-structured connection workflow with explicit state handling. However, it suffers from some unnecessary introductory content, a largely useless popular actions table (all entries lack descriptions), and a cryptic overview section. The content would benefit from trimming filler and better organizing reference material.
Suggestions
Remove or significantly shorten the introductory paragraph about what Agendor is — Claude already knows this, and the skill description covers it.
Either add meaningful descriptions to the popular actions table or remove it entirely, as 20 rows of 'No description' waste tokens without adding value.
Clarify or remove the 'Agendor Overview' section (Contact → Task, Company → Task) which is cryptic and doesn't provide actionable guidance.
Consider extracting the proxy request flags table and detailed CLIENT_ACTION_REQUIRED handling into a separate reference file to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary explanation (e.g., 'Agendor is a CRM and sales management platform. It's used by small and medium-sized businesses...') and the overview section ('Contact → Task, Company → Task') is vague and adds little value. The popular actions table has 'No description' for every entry, wasting tokens. However, the CLI commands and workflow steps are reasonably lean. | 2 / 3 |
Actionability | The skill provides fully executable CLI commands for every step: installation, authentication, connection setup, action discovery, action execution, and proxy requests. Commands are copy-paste ready with clear flag descriptions and JSON parameter examples. | 3 / 3 |
Workflow Clarity | The multi-step connection workflow is clearly sequenced with explicit state checks (READY, BUILDING, CLIENT_ACTION_REQUIRED, errors), polling instructions with --wait flag, and clear branching logic for each state. The overall flow from install → auth → connect → discover → run is well-structured with validation at each stage. | 3 / 3 |
Progressive Disclosure | The content is a single monolithic file with no references to supporting documents. The popular actions table (20 rows, all without descriptions) and the detailed proxy request options could be split into separate reference files. The overview section ('Contact → Task, Company → Task') is cryptic and doesn't serve as useful navigation. | 2 / 3 |
Total | 10 / 12 Passed |