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 blockmatic/basilic --skill file-organization-v1git clone --depth 1 https://github.com/blockmatic/basilicWrote 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/blockmatic/basilic/file-organization-v1)<a href="https://agentmods.dev/skills/blockmatic/basilic/file-organization-v1"><img src="https://agentmods.dev/badge/skills/blockmatic/basilic/file-organization-v1.svg" alt="Measured on agentmods" height="20"></a>- NVIDIA SkillSpector pass
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.00054 | $0.00751 |
| Opus 5 | $0.00027 | $0.00376 |
| Sonnet 5 | $0.00011 | $0.00150 |
| Haiku 4.5 | $0.00005 | $0.00075 |
Grade A, and why
file-organization-v1 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 4d 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.
How it starts
The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Skill: file-organization
Scope
- Applies to: grouping related implementation files in apps and packages,
index.tspublic APIs, import paths, folder naming - Does NOT cover: Next.js lucide-style package import optimization, Fastify route structure, or Drizzle schema design
Assumptions
- TypeScript ESM with
.jsextensions in import specifiers - Kebab-case directory names
- App-local group indexes use named re-exports; package subpaths may use
export *when the folder is a published module boundary
Principles
- A folder groups 2+ implementation files of one concern
index.tsis the group's public API when all exports share a runtime- Drop the folder-name prefix inside the folder (
oauth-google.ts→oauth/google.ts) - Outside the folder, import the group (
.../feature/index.js); inside, import siblings directly - Single-file modules stay files; tests colocate beside implementation
- Mixed runtimes → folder with named entry files, no unifying index
Constraints
MUST
- Use kebab-case folder names
- Use named re-exports in app-local group indexes (avoid
export *mega-barrels) - Resolve basename collisions before creating a folder (
auth.tsvsauth/)
MUST NOT
- Add parent mega-barrels (
lib/index.ts,components/ui/index.ts) - Create
foo/foo.tsplus a thin re-export index - Add
index.tsin Fastify autoload trees (routes/,plugins/) - Unify server and client modules in one index when they use different runtimes
SHOULD
- Keep group indexes small and cohesive (one feature domain)
- Use named entry files when re-exporting would create import cycles
- Prefer existing package subpaths over new root barrels
Interactions
- Complements next-v16 (barrel import optimization ≠ feature group indexes)
- Complements typescript-v6 (ESM paths, named exports)
- Repo rules override this skill when they specify exceptions (catalogs mapper, Drizzle schema index)
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.
- 4d ago First seen · 95 lines · 54 tokens per session scan A 009cd1989fa7
file-organization-v1 is a skill published in the GitHub repository blockmatic/basilic (89 stars, last pushed yesterday), licensed MIT. It adds 54 tokens to every session and 751 once invoked, about $0.0003 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-09-03.
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.
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…
dd-code-generation
Use pup CLI for immediate Datadog operations or generate code for integration into applications.
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.