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 maksimzayats/specx --skill specx-foundationgit clone --depth 1 https://github.com/maksimzayats/specxWrote 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/maksimzayats/specx/specx-foundation)<a href="https://agentmods.dev/skills/maksimzayats/specx/specx-foundation"><img src="https://agentmods.dev/badge/skills/maksimzayats/specx/specx-foundation/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/maksimzayats/specx/specx-foundation"><img src="https://agentmods.dev/badge/skills/maksimzayats/specx/specx-foundation.svg" alt="Reviewed on agentmods" width="80" 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.00034 | $0.00555 |
| Opus 5 | $0.00017 | $0.00278 |
| Sonnet 5 | $0.00007 | $0.00111 |
| Haiku 4.5 | $0.00003 | $0.00056 |
Grade A, and why
specx-foundation 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 9d 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 — 53 lines — stays where its author put it; the contents beside it link to each section on GitHub.
specx Foundation
Use this skill when a service class needs an explicit base, or when a new class
category may need a project-local foundation base. Read
references/foundation.md before editing foundation-related code.
Workflow
- Prefer packaged scoped bases from
specx.core.foundation,specx.delivery.foundation, andspecx.infrastructure.foundation. - Do not create an empty
src/<package>/foundation/package. - Add a project-local
foundation/module only when current code needs a real project-local base category or a stateful framework base that must not be shared globally, such as a SQLAlchemy declarative base. - Keep project-local foundation limited to base definitions: marker bases,
common external-base wrappers, justified ABCs, and stateful framework bases.
Put stable cross-scope concrete primitives under
shared/, notfoundation/. - Give every project source class, including each local base, a docstring that explains what it protects and includes a concrete usage example.
- Make every non-foundation project source class inherit an explicit scoped base.
- Name each class with the suffix implied by its base ancestry, such as
TaskDTO,TaskEntity,TaskResponseSchema,CreateTaskUseCase, orTaskTitleNormalizerService. - Use
BaseLifecyclefor delivery app lifespan managers such asFastAPILifecycle. - Prefer
@dataclass(frozen=True, kw_only=True, slots=True)for commands, queries, DTOs, entities, and other core data classes unless the user asks for another model type. - Keep
BaseCommandandBaseQueryas use-case input bases, independent fromBaseDTO. Commands and queries are not result DTOs. - When an application value has a limited known set, model it with
BaseStrEnuminstead of plainstrorLiteral[...]. - Keep business rules, delivery behavior, adapter code, and runtime wiring out of project-local foundation modules.
Code Style
Use blank lines as logical separators in all code. Keep related statements together, but separate independent setup, action, assertion, response, branch, and transformation groups so long blocks stay readable.
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.
- 9d ago First seen · 53 lines · 34 tokens per session scan A 0686fa75da70
specx-foundation is a skill published in the GitHub repository maksimzayats/specx (201 stars, last pushed 1mo ago), licensed MIT. It adds 34 tokens to every session and 555 once invoked, about $0.0002 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.
Other skills, from other repositories
scaffold-archipy-domain
Scaffold a full ArchiPy domain slice (DTOs, errors, repository adapters, logic, service). Use when adding a new domain to an existing ArchiPy app.
scaffold-archipy-app
Scaffold a minimal ArchiPy application package (config, containers stub, domain slice, helpers tree, optional manage.py). Use when starting a new ArchiPy-based service or asking to bootstrap project layout.
scaffold-archipy-logic
Scaffold an ArchiPy logic class with unit-of-work decorator and domain DTO I/O. Use when adding a use-case under logics/{domain}/.
language-python
Python idioms — PEP 8, context managers, generators, asyncio, and testing. Auto-load when working with .py files, pyproject.toml, requirements.txt, or when the user mentions Python, pytest, asyncio, dataclass, type hints, or virtualenv.
scaffold-archipy-utils
Scaffold or wire a helpers/utils module for an ArchiPy app. Prefer ArchiPy utils before inventing custom ones. Use when adding pure utility helpers.
archipy-docs
Look up ArchiPy patterns for app teams using the bundled 5.x reference and live docs. Trigger when the user asks how to use ArchiPy (config, adapters, helpers, errors, DI, project layout, observability).