CtrlK
BlogDocsLog inGet started
Tessl Logo

apollo-reference-architecture

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

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/apollo-pack/skills/apollo-reference-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.