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.
npx skills add joao-aires/agent-skills-public --skill typescript-conventionsgit clone --depth 1 https://github.com/joao-aires/agent-skills-publicWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/joao-aires/agent-skills-public/typescript-conventions)<a href="https://agentmods.dev/skills/joao-aires/agent-skills-public/typescript-conventions"><img src="https://agentmods.dev/badge/skills/joao-aires/agent-skills-public/typescript-conventions/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/joao-aires/agent-skills-public/typescript-conventions"><img src="https://agentmods.dev/badge/skills/joao-aires/agent-skills-public/typescript-conventions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00047 | $0.00826 |
| Opus 5.5 | $0.00019 | $0.00330 |
| Sonnet 5.5 | $0.00009 | $0.00165 |
| Haiku 4.5 | $0.00005 | $0.00083 |
Grade A, and why
typescript-conventions 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 yesterday.
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.
How it starts
The opening of the file, as written. The whole thing — 54 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Match TypeScript to its execution and consumer contracts
Read the repository's supported compiler/runtime versions, package manager/lockfile, scripts, module/package boundaries and accepted conventions. Determine whether the result is a library, service, CLI, browser/native client or shared package. Loading language guidance does not select React, a backend framework, Node, Bun, Deno or a bundler. Read modules and packaging when changing resolution, emitted artifacts or consumers, and sources for primary guidance and upstream selection rationale.
Preserve understandable type contracts
Use types to make valid domain states understandable and invalid combinations difficult to express. Keep related state and behavior together so callers can see what is required for an operation. Prefer inference for local values; use explicit stable public contracts where they help consumers understand and depend on the API.
At JSON/configuration, network, storage and provider boundaries, treat the received value as unknown until the application's validation establishes its shape and meaning. A type assertion changes what the compiler believes; it does not inspect the value. Generated client types and non-null operators likewise cannot establish that runtime input is valid.
Narrow values using validated evidence and retain the distinction between absent, null and optional fields through serialization. Check the actual consumer contract when that distinction changes behavior. Choose the project's existing validation approach rather than adding a schema library solely for this skill.
Use discriminated unions, generics, mapped/conditional types or branded identifiers when they clarify a real contract. Keep common paths readable and account for compiler/editor performance. Avoid introducing an advanced type technique, enum prohibition or complete strictness migration as a prerequisite for a small fix. Preserve an accepted policy; for compatible new work prefer useful strict checking, and stage any migration against the actual codebase.
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- yesterday First seen · 54 lines · 47 tokens per session scan A 92362a86309f
typescript-conventions is a skill published in the GitHub repository joao-aires/agent-skills-public (2 stars, last pushed yesterday), licensed MIT. It adds 47 tokens to every session and 826 once invoked, about $0.0002 per session on Opus 5.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-10-21.
Other skills, from other repositories
no-bare-casts
Writing as in TypeScript or TSX production code, modifying a file that contains a bare as cast, silencing a type error with a cast, encountering as unknown as, or reviewing a cast site.
aws-sst-development
SST v4 (Ion) expert for managing AWS resources as code with the Pulumi-backed framework.
league-akari-shard-development
Use when creating, extending, refactoring, splitting, or reviewing League Akari main or renderer shards, including shard file organization, controller/loader/executor/handler boundaries, naming conventions, renderer TSX usage, platform guards, and public contract compatibility.
dd-code-generation
Use pup CLI for immediate Datadog operations or generate code for integration into applications.
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…
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…