Agent skills

The public skill pack lives at github.com/dbtinoy-/quadkit-skills and follows the open Agent Skills specification (.agents/skills/<name>/SKILL.md plus focused references/*.md files). This docs site also serves a one-file umbrella fallback at /SKILL.md for agents that only fetch a single URL (aliases: /.well-known/skill.md, /.well-known/skills/default/skill.md).

Both the pack and this site enforce the same layout rules: one project tree (domains/, app-root di/, cross-cutting shared/), never a models/ directory. Playbook: For coding agents. Fail vs fix: Common mistakes.

Install

Cross-agent `skills` CLI (recommended)

Install all 10 skills into your current project (supports Claude Code, Cursor, Codex, OpenCode, and more):

npx skills add dbtinoy-/quadkit-skills

List the available skills first, or install a single skill for a specific agent:

npx skills add dbtinoy-/quadkit-skills --list
npx skills add dbtinoy-/quadkit-skills --skill quadkit-framework --agent claude-code

Pass --global for a user-wide install instead of the current repository.

Claude Code (manual git clone)

git clone https://github.com/dbtinoy-/quadkit-skills.git ~/.quadkit-skills
ln -s ~/.quadkit-skills/.agents/skills ~/.claude/skills/quadkit

Restart Claude Code. To pin a snapshot instead of a symlink, copy the skill directories (including their references/ folders) into .claude/skills/ or ~/.claude/skills/.

Cursor

git submodule add https://github.com/dbtinoy-/quadkit-skills.git .cursor/rules/quadkit

Or copy individual skill directories into .agents/skills/ or .cursor/rules/.

OpenCode

Project-scoped — opencode.json:

{
  "plugin": ["quadkit-skills@git+https://github.com/dbtinoy-/quadkit-skills.git"]
}

Globally — add the same plugin entry to ~/.config/opencode/opencode.json and restart; the 10 skills appear on the skill tool.

Any agent that reads markdown

git clone https://github.com/dbtinoy-/quadkit-skills.git

Point your agent’s skill/instructions path at .agents/skills/, or fetch /SKILL.md directly when cloning is unavailable.

What’s in the pack (10 skills · 18-package catalog)

Skill	Packages covered	Use when…
`quadkit-framework`	`quadkit`, `quadkit-contracts`, `quadkit-cli`, all 18 boundaries	Scaffolding an app (`quadkit new` / `quadkit gen`), checking the one-tree layout (`domains/`, `di/`), or routing to a domain skill
`quadkit-contracts`	`quadkit-contracts`	Defining or placing a `@runtime_checkable` `Protocol`, frozen DTO, `StrEnum`, `QuadkitError`, or `QK_ERR_*` error code
`quadkit-di`	`quadkit` (`di`, `app`)	Writing `Provider.register()` / `boot()`, `ProviderPriority`, `@module()`, `DynamicModule`, scopes, or ambient `clock`/`identity`/`hashing`
`quadkit-web`	`quadkit-web`, `quadkit-http`	Building `Controller` routes, `body()`/`query()`/`path()`, `WebModule.configure(discover=[...])`, `Result` → `ProblemDetail`, middleware, SSE/WS, or `HTTPClient`
`quadkit-agents`	`quadkit-ai-llm`, `quadkit-ai-agents`, `quadkit-ai-mcp`	Wiring `LLMModule`, streaming & structured extraction, `AgentsModule` tools/strategies/crews, or `MCPModule` / `MCPClient`
`quadkit-workflows`	`quadkit-workflow`, `quadkit-events`, `quadkit-tasks`, `quadkit-notification`	Orchestrating DAGs, state machines, sagas, `GateNode` HITL, CQRS/event sourcing, background workers/cron, or SMS/push/email/inbox delivery
`quadkit-data`	`quadkit-sql`, `quadkit-cache`, `quadkit-storage`, `quadkit-auth`, `quadkit-monitor`	Configuring async SQL repositories/UoW, Redis/memory cache, S3/GCS/Azure/local blob stores, JWT/OAuth2/RBAC auth, or Prometheus/OTel/health probes
`quadkit-style`	`quadkit` (`result`, `logging`, `primitives`)	Applying Python 3.11+ typing, zero `Any` on boundaries, `Result[T, E]` (`Ok`/`Err`) vs exceptions, structured `get_logger`, async task tracking, and registry dispatch
`quadkit-testing`	`quadkit-testing`	Writing async pytest suites, `assert_ok`/`assert_err_type`, `QuadkitContainerHarness`, `AppTestBed`, `WebTestBed`, `FixedClock`, fakes, and compliance suites
`quadkit-package`	`quadkit-*` extensions	Creating or releasing a `quadkit-*` wheel (`src/quadkit/<name>/` implicit namespace, `pkgutil.extend_path`, `module.py`, `py.typed`, `pyproject.toml`)

Machine indexes stay on this site: /llms.txt, /llms-full.txt, /agents.md, and /llms/index.txt.

Next Steps

For coding agents — read order, repo map, recipes
Common mistakes — fail vs fix
Your First App — scaffold and run
Changelog — the 0.0.50 release
/SKILL.md — one-file umbrella skill