instantly-reference-architecture

Implement Instantly.ai reference architecture with best-practice project layout. Use when designing new Instantly integrations, planning multi-campaign systems, or building an outreach automation platform. Trigger with phrases like "instantly architecture", "instantly project structure", "instantly reference design", "instantly system design", "instantly integration layout".

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/saas-packs/instantly-pack/skills/instantly-reference-architecture/SKILL.md

Quality

Content

55%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a solid architectural overview with executable code and a clear data-flow model, but it over-inlines reference-grade code, lacks an ordered workflow with validation checkpoints for batch/destructive operations, and does not split detail into bundle files despite a >280-line body.

Suggestions

Move the full InstantlyClient and SEQUENCE_TEMPLATES code into separate bundle files (e.g., references/client.md, references/templates.md) and keep only a representative excerpt plus a one-level-deep link in SKILL.md.

Add an explicit ordered workflow with validation checkpoints for batch/destructive operations (e.g., lead import and campaign activation: validate API key -> import a small batch -> verify counts -> activate), including a validate->fix->retry loop.

Convert the named cross-skill pointers ('instantly-performance-tuning', 'instantly-webhooks-events', 'instantly-multi-env-setup') into clearly signaled navigable references or note how to locate them.

Dimension	Reasoning	Score
Conciseness	The body is reasonably efficient and avoids explaining basic concepts, but two large full code blocks (the complete InstantlyClient and the SEQUENCE_TEMPLATES) inline substantial reference material that competes for context budget and could be trimmed to key excerpts.	3 / 5
Actionability	Provides concrete, mostly-executable TypeScript with real endpoint paths and payload shapes, plus a project layout and error-handling table; minor gaps (omitted types, partial template bodies) keep it just below copy-paste-complete.	4 / 5
Workflow Clarity	A rough sequence exists (diagram, data-flow summary, module layout), but it describes architecture rather than an ordered procedure, and there are no validation checkpoints for the batch/destructive operations it implies (lead import, campaign activation) — the feedback-loop cap applies.	3 / 5
Progressive Disclosure	No bundle files exist and the body inlines large API-client and template reference blocks that clearly belong in separate files (e.g., a client reference or templates.md), and cross-skill references like 'instantly-performance-tuning' are named but not navigably linked.	2 / 5
	Total	12 / 20 Passed

Description

91%Weight 40%Scale 1-5

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 is strong: it clearly states what the skill does, when to use it, and supplies concrete, natural trigger phrases scoped to a distinct Instantly.ai niche. Minor verbosity in the 'Use when' enumeration is the only small weakness, but it does not pad with fluff.

Dimension	Reasoning	Score
Specificity	Names the domain (Instantly.ai reference architecture) and several concrete capabilities — 'designing new Instantly integrations, planning multi-campaign systems, or building an outreach automation platform' — with only minor coverage gaps relative to the comprehensive 5 anchor.	4 / 5
Completeness	Explicitly answers both 'what' (implement Instantly.ai reference architecture with best-practice project layout) and 'when' (Use when... + concrete Trigger phrases), satisfying the 5 anchor's requirement for clear what-and-when with concrete trigger phrases.	5 / 5
Trigger Term Quality	Provides a comprehensive set of natural trigger phrases users would plausibly say ('instantly architecture', 'instantly project structure', 'instantly reference design', 'instantly system design', 'instantly integration layout'), matching the comprehensive synonym coverage of the 5 anchor.	5 / 5
Distinctiveness Conflict Risk	The Instantly.ai-specific niche and uniquely 'instantly'-prefixed triggers make it clearly distinguishable from other skills with minimal conflict risk, matching the 5 anchor's clear-niche criterion.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 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	14 / 16 Passed

Repository: jeremylongshore/claude-code-plugins-plus-skills
Path: plugins/saas-packs/instantly-pack/skills/instantly-reference-architecture/SKILL.md
Commit: 0540a62

Reviewed: about 17 hours ago

Table of Contents

Discovery Implementation Validation

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.