inngest-local

Set up self-hosted Inngest on macOS as a durable background task manager for AI agents. Interactive Q&A to match intent — from Docker one-liner to full k8s deployment with persistent state. Use when: 'set up inngest', 'background tasks', 'durable workflows', 'self-host inngest', 'event-driven functions', 'cron jobs', or any request for a local workflow engine.

2.93x

Quality

88%

Does it follow best practices?

Impact

94%

2.93x

Average score across 3 eval scenarios

Securityby

Advisory

Suggest reviewing before use

Quality

Content

77%

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

This is a strong, highly actionable skill with excellent executable examples across three deployment tiers and a complete worker tutorial. The workflow is clearly sequenced with good validation checkpoints. The main weakness is that it's a large monolithic document that would benefit from splitting detailed content (k8s manifests, launchd configs, patterns) into separate bundle files, and some sections (Decision Chain, Credits, Intent Alignment Q&A) add token weight without proportional value for Claude's task execution.

Suggestions

Split the k8s YAML, launchd plist, and patterns into separate bundle files (e.g., k8s/inngest.yaml, launchd/worker.plist, PATTERNS.md) and reference them from the main skill to improve progressive disclosure.

Trim or remove the Decision Chain/ADR table and Credits sections — these provide architectural context for humans but don't help Claude execute the skill.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with good code examples and practical content, but includes some unnecessary sections (Credits, Decision Chain ADRs, Setup Script for an external URL) and the Intent Alignment Q&A section adds bulk that could be trimmed. The gotchas section is valuable but slightly verbose.	2 / 3
Actionability	Excellent actionability throughout — every tier has copy-paste-ready Docker/k8s commands, the worker build is a complete 6-step walkthrough with fully executable TypeScript, and patterns include concrete code examples. The curl test command, launchd plist, and k8s YAML are all production-ready.	3 / 3
Workflow Clarity	The tiered setup is clearly sequenced (Tier 1→2→3), the worker build follows explicit numbered steps (1-6), and the verification section provides a checklist with specific validation criteria including failure recovery testing ('Kill the worker mid-function — restart worker, function resumes'). The reboot survival section clearly explains the sequence of events.	3 / 3
Progressive Disclosure	The content is well-structured with clear sections and headers, but it's a long monolithic file (~300 lines) with no bundle files to offload detail into. The k8s YAML, launchd plist, patterns section, and ADR table could all be separate referenced files. References to external ADRs exist but no actual bundle files support them.	2 / 3
	Total	10 / 12 Passed

Description

100%

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 strong skill description that clearly communicates what the skill does (set up self-hosted Inngest with various deployment options), when to use it (explicit trigger terms covering multiple natural phrasings), and differentiates itself through product-specific and platform-specific language. It uses proper third-person voice and is concise yet comprehensive.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions and deployment options: 'self-hosted Inngest on macOS', 'Docker one-liner', 'full k8s deployment with persistent state', 'Interactive Q&A to match intent'. These are specific, actionable capabilities.	3 / 3
Completeness	Clearly answers both 'what' (set up self-hosted Inngest on macOS as a durable background task manager, interactive Q&A, Docker to k8s deployment) and 'when' (explicit 'Use when:' clause with multiple trigger phrases).	3 / 3
Trigger Term Quality	Excellent coverage of natural trigger terms: 'set up inngest', 'background tasks', 'durable workflows', 'self-host inngest', 'event-driven functions', 'cron jobs', 'local workflow engine'. These are terms users would naturally use when seeking this functionality.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive — targets a specific product (Inngest), a specific platform (macOS), and a specific use case (self-hosted durable workflow engine). The combination of product name and deployment context makes conflicts with other skills very unlikely.	3 / 3
	Total	12 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: joelhooks/joelclaw
Commit: 2ca3686

Reviewed: 10 days 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.