Updated 2mo ago
by maksimzayats
specx
⚙️ Executable architecture guardrails and agent skills for building structured Python services!
202 GitHub stars (202)
+1 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | +1 |
| Oct 2 | 0 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 12 skills (12 skills found in its SKILL.md files)
- 34 forks (34 forks)
- 2mo ago last update (Last updated 2mo ago)
Install
Skills CLI
npx skills add maksimzayats/specx
Asks which skills and agents to install. Just one: npx skills add maksimzayats/specx --skill specx-add-core-service — add -g for every project.
Claude Code
git clone https://github.com/maksimzayats/specxcp -r "specx/skills/specx-add-core-service" ~/.claude/skills/
Copies the specx-add-core-service skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add maksimzayats/specx
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
specx-add-core-service
Add or refactor a specx core scope service. Use when implementing focused reusable business/application behavior under a core scope services package, extracting logic from a use case, injecting deterministic collaborators, accepting an active unit of work, choosing between Service and Capability, or keeping business decisions away from delivery and infrastructure.
skills/specx-add-core-service/SKILL.md on GitHub (opens in a new tab) -
specx-add-core-use-case
Add or refactor a specx core scope use case. Use when implementing an externally meaningful application action under a core scope use_cases package, adding same-file command/query inputs, result DTOs, coordinating services, opening a unit-of-work transaction, or moving behavior out of delivery or infrastructure into class-based application code.
skills/specx-add-core-use-case/SKILL.md on GitHub (opens in a new tab) -
specx-add-delivery-controller
Add delivery controllers for specx services, especially FastAPI HTTP routes. Use when creating top-level `delivery/` request/response schemas, one controller per scoped use-case set, route registration, FastAPI lifecycle managers, HTTP error translation, delivery-only auth/rate-limit/request services, or integration tests that exercise the delivery edge.
skills/specx-add-delivery-controller/SKILL.md on GitHub (opens in a new tab) -
specx-add-infrastructure-adapter
Add technical infrastructure adapters for specx core scopes. Use when implementing SQLAlchemy repositories and Alembic-backed persistence, Redis stores, HTTP/network clients, file or queue adapters, unit-of-work implementations, gateway implementations for external APIs or SDKs such as OpenAI, or explicit `diwire` bindings for core scope repository and gateway ports.
skills/specx-add-infrastructure-adapter/SKILL.md on GitHub (opens in a new tab) -
specx-component-architecture
Design or review specx core scope boundaries in Python services. Use when deciding where code belongs across packaged scoped foundation bases, optional local foundation extensions, `core/`, capabilities, delivery, infrastructure, `shared/`, and `ioc`; when adding guardrails or splitting use cases, services, DTOs, schemas, ports, and adapters.
skills/specx-component-architecture/SKILL.md on GitHub (opens in a new tab) -
specx-diwire-composition
Wire dependency injection for a specx Python service with `diwire`. Use when adding `ioc/container.py`, explicit dependency registrations for capabilities, repositories, gateways, UoW managers, clients, settings, or factories, `Injected[...]` constructor fields, FastAPI app factory/lifecycle composition, test overrides, or rules that keep containers out of core use cases and services.
skills/specx-diwire-composition/SKILL.md on GitHub (opens in a new tab) -
specx-foundation
Use specx foundation bases in Python services, or add a tiny project-local `foundation/` base for missing categories or stateful framework bases.
skills/specx-foundation/SKILL.md on GitHub (opens in a new tab) -
specx-project-structure
Create or reshape a Python FastAPI service repo into the specx clean core/delivery architecture using packaged scoped foundation bases. Use when starting an API backend, adding the first src package, or establishing `AGENTS.md`, `core/`, optional local `foundation/`, `delivery/`, infrastructure, `ioc/`, migrations, and tests.
skills/specx-project-structure/SKILL.md on GitHub (opens in a new tab) -
specx-project-tooling
Add strict Python project tooling for a specx service. Use when creating or updating `pyproject.toml`, `uv` dependency groups and lock checks, Ruff formatting and linting, mypy strict mode, pytest and HTTPX2 test configuration, Makefile commands, root `AGENTS.md` command guidance, or CI-like local guardrails.
skills/specx-project-tooling/SKILL.md on GitHub (opens in a new tab) -
specx-settings
Add runtime configuration to specx Python services with `pydantic-settings`. Use when creating settings classes, environment variables, `.env.example`, injecting settings at delivery, infrastructure, or composition edges, documenting config, mapping configuration into typed core policy collaborators, or removing direct environment reads from core code.
skills/specx-settings/SKILL.md on GitHub (opens in a new tab) -
specx-sqlalchemy-migrations
Add or repair Alembic migrations for specx SQLAlchemy services. Use when adding SQLAlchemy models or repositories, replacing metadata.create_all schema bootstraps, creating async Alembic env.py, adding migration Makefile targets, generating initial revisions, or testing migration drift.
skills/specx-sqlalchemy-migrations/SKILL.md on GitHub (opens in a new tab) -
specx-tests
Add or refine tests for specx Python services. Use when creating unit tests for use cases/services, integration tests for FastAPI controllers or infrastructure adapters, e2e smoke tests, architecture import guardrails, DI override tests, pytest fixtures, or coverage and boundary checks.
skills/specx-tests/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.