instantly-hello-world
Create a minimal working Instantly.ai example with real API calls. Use when starting a new Instantly integration, testing your setup, or learning basic Instantly API v2 patterns. Trigger with phrases like "instantly hello world", "instantly example", "instantly quick start", "simple instantly code", "test instantly api".
64
77%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/instantly-pack/skills/instantly-hello-world/SKILL.mdQuality
Discovery
89%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 is a well-structured description with strong completeness and distinctiveness. It clearly communicates the 'what' and 'when', and provides explicit trigger phrases that are natural and specific to the Instantly.ai domain. The main weakness is that the specific capabilities could be more detailed — listing concrete actions beyond 'create a minimal working example' would strengthen specificity.
Suggestions
Add more specific concrete actions, e.g., 'authenticate with API key, list campaigns, send a test email' to improve specificity from general to comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (Instantly.ai API v2) and a general action ('Create a minimal working example with real API calls'), but doesn't list multiple specific concrete actions like authenticating, sending campaigns, fetching leads, etc. | 2 / 3 |
Completeness | Clearly answers both 'what' (create a minimal working Instantly.ai example with real API calls) and 'when' (starting a new integration, testing setup, learning basic API v2 patterns), with explicit trigger phrases. | 3 / 3 |
Trigger Term Quality | Includes explicit natural trigger phrases like 'instantly hello world', 'instantly example', 'instantly quick start', 'simple instantly code', 'test instantly api' — these are terms a user would naturally say when starting with Instantly. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific to Instantly.ai API v2 with distinct trigger terms; very unlikely to conflict with other skills since 'Instantly' is a specific product name and the use case (hello world / quick start) is narrowly scoped. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid hello-world skill with highly actionable, executable code examples and a useful error handling reference table. Its main weaknesses are moderate verbosity for what should be a minimal example (typed interfaces, extensive status label mappings, percentage calculations) and lack of inline validation checkpoints between workflow steps. The curl quick-test section is a nice touch for rapid verification.
Suggestions
Trim the TypeScript examples to be truly minimal — remove the STATUS_LABELS exhaustive mapping and percentage calculations, which add complexity beyond a 'hello world' scope.
Add a validation checkpoint after Step 1 (e.g., 'If campaigns is empty, stop here and create a campaign first') to make the workflow more robust.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The code examples are reasonably efficient but include some unnecessary verbosity — the STATUS_LABELS mapping with all edge cases, verbose console.log formatting, and typed interfaces for a 'hello world' example add bulk. The error handling table and resources section are useful but the overall content could be tightened for a minimal example. | 2 / 3 |
Actionability | Provides fully executable TypeScript code with typed interfaces, concrete API endpoints, and a curl alternative for quick testing. The code is copy-paste ready with real endpoint paths, query parameters, and HTTP methods clearly specified. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (list campaigns → check accounts → pull analytics → run all), but there are no validation checkpoints between steps. The main() function has no error handling between steps, and there's no guidance on what to do if Step 1 fails before proceeding to Step 2. The error handling table is helpful but separate from the workflow. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections, but all code is inline in a single file rather than being split appropriately. For a hello world skill this is borderline acceptable, but the references to 'instantly-install-auth' and 'instantly-core-workflow-a' provide good navigation to related skills. No bundle files exist to offload the detailed code examples. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
d41e58e
- 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.