Implement Apollo.io reference architecture. Use when designing Apollo integrations, establishing patterns, or building production-grade sales intelligence systems. Trigger with phrases like "apollo architecture", "apollo system design", "apollo integration patterns", "apollo best practices architecture".
59
70%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/apollo-pack/skills/apollo-reference-architecture/SKILL.mdQuality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has strong completeness with explicit 'Use when' and 'Trigger with' clauses, and is highly distinctive due to its narrow Apollo.io architecture focus. However, it could benefit from more concrete action verbs describing what the skill actually produces, and broader natural trigger term coverage beyond the architecture-focused phrases.
Suggestions
Add specific concrete actions like 'Define API integration layers, configure webhook handlers, establish rate-limiting patterns, set up contact enrichment pipelines' to improve specificity.
Expand trigger terms to include more natural user phrases like 'apollo api', 'apollo.io setup', 'sales intelligence pipeline', 'apollo enrichment', 'apollo CRM integration' to capture a wider range of user queries.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Apollo.io integrations, sales intelligence systems) and mentions some actions like 'designing integrations', 'establishing patterns', and 'building production-grade systems', but these are fairly abstract rather than listing concrete specific actions like 'configure webhook endpoints, set up contact enrichment pipelines, implement rate-limited API calls'. | 2 / 3 |
Completeness | The description clearly answers both 'what' (implement Apollo.io reference architecture for production-grade sales intelligence systems) and 'when' (explicit 'Use when' clause with trigger scenarios and a 'Trigger with phrases' section listing specific activation terms). | 3 / 3 |
Trigger Term Quality | Includes some relevant trigger terms like 'apollo architecture', 'apollo system design', 'apollo integration patterns', and 'apollo best practices architecture'. However, these are somewhat formulaic and miss natural user phrases like 'apollo api', 'apollo.io setup', 'sales intelligence pipeline', 'apollo enrichment', or 'apollo CRM integration'. | 2 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to Apollo.io reference architecture and sales intelligence systems, making it very unlikely to conflict with other skills. The combination of 'Apollo.io' + 'architecture' + 'sales intelligence' creates a clear, distinct niche. | 3 / 3 |
Total | 10 / 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, highly actionable reference architecture skill with real, executable TypeScript code covering all major integration layers with Apollo.io. Its main weaknesses are verbosity (providing both Prisma and TypeORM examples, lengthy inline code that could be split into referenced files) and the lack of validation checkpoints between steps for what is a complex, multi-component system setup.
Suggestions
Add validation checkpoints between steps — e.g., 'Verify API connectivity by running a test search before proceeding to Step 3' and 'Run database migration and confirm schema before setting up routes'.
Split detailed implementation code into separate referenced files (e.g., `services/lead-service.ts`, `services/deal-service.ts`, `jobs/enrichment-job.ts`) and keep SKILL.md as a concise overview with architecture diagram and brief descriptions pointing to those files.
Choose one ORM (Prisma or TypeORM) for the database model instead of showing both, or move the alternative to a separate reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill provides substantial executable code which is valuable, but it's quite long (~200+ lines) with some redundancy (both Prisma and TypeORM examples for the same model). The architecture diagram and layered explanation are useful but the overall content could be tightened — e.g., picking one ORM, trimming comments, and consolidating the Output section which largely restates what's already shown. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code across all layers — API client usage, service classes, BullMQ job processing, database models, and Express routes. Code is copy-paste ready with real Apollo API endpoints and correct parameter structures. | 3 / 3 |
Workflow Clarity | Steps are numbered and sequenced logically (architecture → services → jobs → models → routes), but there are no validation checkpoints between steps. For a production architecture involving database setup, API integration, and background jobs, there should be explicit verification steps (e.g., test API connectivity, validate schema migration, verify queue processing) — their absence caps this at 2. | 2 / 3 |
Progressive Disclosure | The skill is a monolithic document with all implementation details inline rather than split into separate files for each layer. For a reference architecture of this complexity, the service layer, deals service, job processing, and database models could each be referenced files. The 'Next Steps' reference to 'apollo-multi-env-setup' is good, and the Resources section provides useful external links, but the main content would benefit from better splitting. | 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 | |
05447c0
Table of Contents
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.