using-triadjs

An overview skill for TriadJS, a TypeScript framework that uses one router definition to produce validation, types, OpenAPI and AsyncAPI documentation, Gherkin scenarios, behavior-driven tests, and Drizzle database schemas.

In plain words
What is it for?
Starting or organizing a TriadJS backend, designing schemas, declaring HTTP endpoints or WebSocket channels, writing BDD scenarios, generating documentation, and connecting definitions to a database.
Why use it?
It helps choose the right TriadJS workflow and keeps related outputs based on the same definition. Gherkin is a plain-language format for describing software behavior, while BDD means testing behavior from those descriptions.

Skill for Claude CodeCodex

Part of the triadjs plugin — 10 skills, 8 commands shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/justhamade/triadjs/using-triadjs
Any agent
npx skills add justhamade/triadjs --skill using-triadjs
Clone the repo
git clone --depth 1 https://github.com/justhamade/triadjs

Made for: Claude Code, Codex.

Or install triadjs, the plugin that ships this one along with the rest of its 10 skills, 8 commands.

Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,996 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00085 $0.01996
Opus 5 $0.00043 $0.00998
Sonnet 5 $0.00017 $0.00399
Haiku 4.5 $0.00009 $0.00200

Measured 3d ago against content hash 70ce68c9b804, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

using-triadjs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin/skills/using-triadjs/SKILL.md · 142 lines

How it starts

The opening of the file, as written. The whole thing — 142 lines — stays where its author put it; the contents beside it link to each section on GitHub.

TriadJS

TriadJS is a TypeScript-first API framework where one declarative definition produces runtime validation, static types, OpenAPI 3.1, AsyncAPI 3.0, Gherkin .feature files, executable BDD tests, and Drizzle database schemas. Every downstream artifact is a deterministic projection of the router.

                +-------------------+
                |  Triad Router     |
                |  (source of       |
                |   truth)          |
                +---------+---------+
                          |
   +---------+------------+------------+-----------+
   |         |            |            |           |
   v         v            v            v           v
OpenAPI  AsyncAPI     Gherkin      BDD tests    Drizzle
 3.1      3.0        features     (in-proc)     tables

When to use each sub-skill

Task Skill
Design schemas (t.model, t.value, DDD entities/value objects) triad-schema
Declare HTTP endpoints, handlers, beforeHandler auth hooks, request/response shapes triad-endpoint
Declare WebSocket channels, per-connection state, broadcast/send typing triad-channel
Write BDD scenario().given().when().then() tests and learn the assertion phrase table triad-behaviors
Wire up a test runner (test-setup.ts, fixtures, scenario.auto(), per-scenario DB isolation) triad-testing
Mount the router on Fastify, Express, or Hono triad-adapters
Generate Drizzle tables from .storage() hints triad-drizzle
Reference the triad CLI (test, docs, gherkin, db generate, validate, fuzz) triad-cli
Register services on ServiceContainer and inject repositories/clients triad-services

These sub-skills each load progressively — read only the ones needed for the task at hand.

Slash commands

The plugin ships these /triadjs:* commands for common workflows:

  • /triadjs:new — scaffold a new TriadJS project from scratch (package.json, router, server, test config)
  • /triadjs:model — add a new t.model or value object to an existing project
  • /triadjs:endpoint — add a new HTTP endpoint with behaviors
  • /triadjs:channel — add a new WebSocket channel
  • /triadjs:scenario — add BDD behavior scenarios to an existing endpoint
  • /triadjs:test — run triad test and explain any failures
  • /triadjs:docs — regenerate OpenAPI/AsyncAPI via triad docs
  • /triadjs:validate — run triad validate --strict and fix any issues

Read the full file on GitHub · 142 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 142 lines · 85 tokens per session scan A 70ce68c9b804

Subscribe to this mod's changes

using-triadjs is a skill published in the GitHub repository justhamade/triadjs (23 stars, last pushed 4mo ago), licensed MIT. It adds 85 tokens to every session and 1,996 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

client-setup

Create a vanilla tRPC client with createTRPCClient (), configure link chain with httpBatchLink/httpLink, dynamic headers for auth, transformer on links (not client constructor). Infer types with inferRouterInputs and inferRouterOutputs. AbortController signal support. TRPCClientError typing.

trpc/trpc · 63 tokens

custom-features

Author a TanStack Table v9 feature plugin across every FeatureMap and API installation surface: state, options, column definitions, table, column, row, cell, header, row-model functions/caches, defaults, prototypes, and table/row/column instance data lifecycles. Load for initTableInstanceData, resetTableInstanceData…

TanStack/table · 93 tokens

effect-and-errors

Composing Effect programs, domain errors, HttpError, repository error types, or error propagation at HTTP boundaries.

latitude-dev/latitude-llm · 26 tokens

migrate-better-result-3

Migrate a TypeScript codebase from better-result 2.x to 3.0. Use when upgrading better-result across the TaggedError syntax, removed Result serialization helpers, recovery inference, matching, or retry APIs.

dmmulroy/better-result · 52 tokens

fast-typescript-check

Keep www-sacred's TypeScript fast to type-check and fast to run. Use when touching the ASCII/canvas animation components (the only real per-frame code here), tightening type-check wall-clock, or auditing a change for runtime or compiler regressions. Scoped to this repo — a React 19 / Next.js 16 component library plus…

internet-development/www-sacred · 84 tokens

typescript-magician

Designs complex generic types, refactors any types to strict alternatives, creates type guards and utility types, and resolves TypeScript compiler errors. Use when the user asks about TypeScript (TS) types, generics, type inference, type guards, removing any types, strict typing, type errors, infer, extends…

mcollina/skills · 108 tokens