Content
75%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.
A well-structured, actionable skill file: exact tool names, copy-paste setup, sequenced workflows with pre-flight checks, and a useful troubleshooting table. Its main gaps are a small amount of promotional padding, absent tool-call parameter examples, and no progressive-disclosure split of the 34-tool detail into a reference file.
Suggestions
Trim the marketing copy ('supports 150+ countries', 'so you can manage your entire job hunt from your AI coding assistant') to keep every token load-bearing.
Add one concrete example of an actual tool call with key parameters (e.g., the search_jobs filter arguments) so the examples are copy-paste executable rather than narrated.
Consider moving the full 34-tool catalog or per-workflow details into a references file (e.g., TOOLS.md) linked from SKILL.md to lighten the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean — exact tool names, commands, and URLs with no explanation of concepts Claude already knows. Minor trimmable padding remains, e.g. the promotional 'supports 150+ countries' sentence and 'so you can manage your entire job hunt from your AI coding assistant', placing it at the 'efficient; minor instances of over-explanation' anchor. | 4 / 5 |
Actionability | Setup gives a copy-paste-ready command ('claude mcp add jobgpt -t http -u https://mcp.6figr.com/mcp --header ...') and every example names the exact MCP tools to call in sequence. It stops short of showing parameters or call payloads for the tools, leaving minor gaps that keep it below the fully-executable anchor. | 4 / 5 |
Workflow Clarity | Multi-step flows are clearly sequenced — the auto-apply example runs resume check -> match_jobs -> add_job_to_applications -> apply_to_job -> get_application_stats, with pre-flight checkpoints ('Check credits first', 'get_profile first') and a troubleshooting table for error recovery. A minor gap: no explicit post-apply verification/retry loop for the batch auto-apply operation, so it sits at 'clear sequence with most checkpoints present'. | 4 / 5 |
Progressive Disclosure | The single file is well organized into Overview, When to Use, Setup, Examples, Best Practices, Troubleshooting, and Resources with clear section navigation and no nested references. At ~92 lines it exceeds the short-skill threshold, and the 34-tool catalog could justify a reference file, so it earns 'good structure; minor organization gaps' rather than a top score. | 4 / 5 |
Total | 16 / 20 Passed |