effectorHQ v1.0 — Typed AI Agent Tools, Now Public

[Jah-yee]

We have been building in public from the start, but this is the first time everything is stable, scoped, and connected end-to-end. Here is what shipped.

---

What shipped

A runtime-neutral capability layer for AI agent tools: author once, parse/validate/type-check/audit/compile to any runtime.

The core stack

Package	What it does	Release
@effectorhq/core	Shared kernel — TOML/SKILL parser, type checker, schema validator, 4 compile targets	v1.0.0
@effectorhq/types	Standard capability types — 35+ types for inputs/outputs/context	v1.0.0
@effectorhq/audit	Static security scanner + permission drift detection	v1.0.0

The toolchain

Package	What it does	Release
@effectorhq/create-effector	Scaffold any Effector type in 30 seconds	v1.0.0
@effectorhq/skill-lint	CLI linter for SKILL.md (16 rules)	v0.2.0
@effectorhq/skill-eval	Static quality scorer — A/B/C/D/F	v0.1.0
@effectorhq/compose	Type-checked pipeline composition	v1.0.0
@effectorhq/graph	Capability graph queries and path-finding	v1.0.0
@effectorhq/skill-mcp	SKILL.md → MCP bridge (Claude / Cursor / Windsurf)	v0.1.0
skill-lint-action	GitHub Action — inline PR annotations	v2.0.0

---

The 30-second golden path

npx @effectorhq/create-effector my-skill --type skill
cd my-skill

npx @effectorhq/skill-lint .              # structure lint
npx @effectorhq/skill-eval . --static-only # quality score (A–F)
npx @effectorhq/core validate .           # schema + type-check
npx @effectorhq/core compile . -t mcp     # emit MCP tool schema

From scaffold to a Claude/Cursor-ready MCP tool in under a minute.

---

Compile targets (end-to-end examples)

One effector definition, four runtimes:

• MCP tool schema — for Claude, Cursor, Windsurf
• OpenAI Agents FunctionTool
• LangChain StructuredTool
• JSON IR — for custom pipelines

---

Read more

Typed AI Agent Tools — blog post

---

How to contribute

• Open an issue in the relevant repo
• Start building with npx @effectorhq/create-effector
• See the reference implementation for a Grade A skill
• Read CONTRIBUTING.md