Devctl Skills

A curated set of development skills for AI coding agents, distributed both as standalone skills and as an installable Codex plugin.

Each skill gives focused guidance, defaults, and reference material for a specific kind of engineering work.

Available Skills

pragmatic-work

An explicit-only modifier that applies DRY, YAGNI, KISS, and SOLID pragmatically to any LLM task. It favors the simplest complete result, avoids repetition and speculative scope, and keeps responsibilities and dependencies clear.

devctl

The entrypoint for Devctl-managed projects, manifests, CLI workflows, and implementation-skill routing.

Use when:

• Interviewing for a new project's shape
• Creating or updating devctl.yaml
• Running Devctl initialization, synchronization, linting, or generation
• Choosing the language, frontend, or contract skill for follow-up work

Covers:

• Project and component discovery
• Declarative manifests and environment configuration
• Safe CLI workflows for validate, inspect, sync, lint, and gen
• Routing to the matching devctl-* skill

devctl-go

Go architecture guidance for services, reusable libraries, packages, and multi-library monorepos.

Use when:

• Creating, organizing, refactoring, or reviewing Go projects
• Designing package APIs, services, use cases, repositories, or clients
• Adding transport adapters, dependency wiring, configuration, or migrations
• Establishing tests, observability, deployment packaging, or quality tooling

Covers:

• Inward dependency boundaries and consumer-owned interfaces
• Domain, service, use-case, repository, client, platform, and transport layers
• Outside-in TDD, gomock/mockgen, and Go-native verification
• Runtime lifecycle, generated code, monorepos, Docker, Helm, and Kubernetes

devctl-openapi

OpenAPI 3.1 contract guidance for compact, downstream-friendly API schemas.

Use when:

• Authoring or reviewing OpenAPI 3.1 contracts
• Adding resource domains, paths, or operations
• Designing request and response schemas
• Standardizing error responses or validation issue contracts

Covers:

• Root contracts with domain files and shared components
• Strict object schemas, identifiers, timestamps, enums, and examples
• Operation IDs, request bodies, responses, and status conventions
• Problem details, facts-based validation errors, and localized-string boundaries
• oneOf plus discriminator patterns for variant schemas

devctl-python

Python architecture guidance for services, libraries, packages, CLI applications, and multi-package repositories.

Use when:

• Creating, organizing, refactoring, or reviewing Python projects
• Designing package APIs, services, use cases, repositories, or clients
• Adding HTTP, gRPC, messaging, CLI, configuration, or migration boundaries
• Establishing pytest strategy, observability, packaging, or quality tooling

Covers:

• pyproject.toml, src-layout packages, and typed public APIs
• Domain, service, use-case, repository, client, platform, and transport layers
• Consumer-owned protocols, outside-in TDD, uv, Ruff, pytest, and typing
• Runtime wiring, generated code, monorepos, Docker, Helm, and Kubernetes

devctl-react-vite

React + Vite + TypeScript project structure guidance for feature-oriented apps.

Use when:

• Creating, organizing, refactoring, or migrating React + Vite apps
• Defining feature modules, shared code, and app-wide infrastructure
• Wiring routes, pages, services, generated API code, or dependency injection
• Adding form validation, i18n, UI states, Storybook coverage, or tests

Covers:

• Project structure and module boundaries
• TanStack Router file-based routes and route-facing page composition
• Service boundaries, error handling, and React Query data flow
• React Hook Form, Zod validation, i18n resources, and document locale metadata
• Storybook stories, UI loading/error/empty states, and testing conventions

devctl-rust

Rust architecture guidance for reusable crates, Cargo workspaces, servers, CLIs, workers, and Tauri applications.

Use when:

• Creating, organizing, refactoring, or reviewing Rust projects
• Designing crate APIs, services, use cases, repositories, or clients
• Adding delivery crates, async runtime wiring, generated code, or migrations
• Establishing tests, observability, deployment packaging, or quality tooling

Covers:

• Minimal crate graphs, reusable application cores, and inward dependencies
• Domain, service, use-case, repository, client, platform, and delivery modules
• Consumer-owned traits, outside-in TDD, Cargo checks, and Clippy
• Tauri/UI monorepos, Docker, Compose, Helm, and Kubernetes

Install the Codex Plugin

Add the GitHub repository as a marketplace, then install the plugin:

codex plugin marketplace add devctllabs/devctl-skills
codex plugin add devctl@devctl

Start a new Codex session after installation so the bundled skills are loaded.

For local development, add the repository checkout instead:

codex plugin marketplace add .
codex plugin add devctl@devctl

Install Standalone Skills

Copy one or more folders from skills/ into a skills directory supported by your agent runtime. Keep folder names unchanged so prompts can reference the same skill names.

Invoke a skill explicitly when needed:

Use $pragmatic-work to keep this task simple, focused, and well-structured.
Use $devctl to create a project manifest and choose the implementation skill.
Use $devctl-openapi to add a resource domain to an OpenAPI 3.1 contract.
Use $devctl-react-vite to organize a React + Vite TypeScript application.

Skills use progressive disclosure: start with SKILL.md, then load only the references relevant to the task.

Plugin Maintenance

The root skills/devctl* directories are the source of truth. The installable bundle under plugins/devctl/skills/ is generated and committed to the repository.

Regenerate the bundle after changing a Devctl skill:

python3 scripts/sync_devctl_plugin.py

Check for drift without modifying files:

python3 scripts/sync_devctl_plugin.py --check

The synchronizer automatically includes current and future skill directories named devctl or devctl-*.

Skill Structure

skills/
  <skill-name>/
    SKILL.md
    agents/openai.yaml
    references/

Skills can also include scripts and assets when deterministic helpers or reusable files are useful.

License

Apache-2.0. See LICENSE.