Documentation
reference/agent-skill-catalog.md
Agent, Skill & Command Catalog
This document catalogs all agents, skills, and commands available in the acsis-core repository. Use it to quickly find the right tool for your task.
See also: Agent Usage Policy for detailed usage guidelines and decision frameworks.
Agents
Agents are autonomous specialists invoked via the Task tool. They run as subagents with deep domain expertise.
| Agent | Model | Purpose | When to Use |
|---|---|---|---|
| code-reviewer-dynaplex | opus | Dynaplex-focused code reviews | Code reviews checking architectural compliance, pattern adherence, security, performance |
| component-scaffolder | haiku | Scaffold new Dynaplex components | Creating new components with the standard 4-project structure (Abstractions, Database, Implementation, ApiClient) |
| config-validator | haiku | Validate appsettings.json files | Checking MQTT config, database connections, naming conventions, required fields |
| csharp-doc-writer | sonnet | Add XML documentation to C# code | Adding or improving XML doc comments after writing code or during reviews |
| documentation-guardian | sonnet | Maintain component documentation | Creating/updating README files, ADRs, configuration references, troubleshooting guides |
| dynaplex-architect | opus | Highest-level architectural authority | Architectural boundary violations, component structure validation, strategic decisions, ADR creation |
| dynaplex-ef-analyzer | sonnet | Analyze EF Core contexts and migrations | Questions about migration history, schema changes, EF configuration, database components |
| dynaplex-navigator | sonnet | Locate files and understand structure | Finding files, translating casual component names to paths, placement guidance for new code |
| ef-core-model-formatter | haiku | Format EF Core model classes | Standardizing Column attributes, property naming, table naming, database conventions |
| entity-refactoring-agent | sonnet | Refactor entities from long/int to Guid | Migrating primary keys to Guid, Passport integration, TenantId standardization |
| mqtt-processor-specialist | sonnet | Implement MQTT processors | Adding MQTT message processing for IoT devices (Zebra RFID readers, etc.) |
| pattern-enforcer | haiku | Enforce Dynaplex patterns | Checking service lifetime patterns, DateTime handling, MQTT patterns, namespace conventions |
| test-engineer | sonnet | Create comprehensive tests | Writing unit tests, integration tests, TDD for microservices |
| troubleshooter | opus | Diagnose and fix common issues | Service lifetime errors, PostgreSQL DateTime issues, MQTT session problems, build errors |
| ui-page-migration-specialist | sonnet | Migrate UI pages to Dynaplex | Full-stack migrations: permissions, API clients, response handling, backend patterns |
| ui-permission-migration-specialist | sonnet | Migrate permissions to hierarchical system | Creating permission manifests, implementing hierarchical permissions, updating frontend pages |
| validation-modernizer | haiku | Modernize FluentValidation to DataAnnotations | Removing FluentValidation, creating Draft models with DataAnnotations, refactoring endpoints |
Agent Model Distribution
- opus (3): code-reviewer-dynaplex, dynaplex-architect, troubleshooter
- sonnet (9): csharp-doc-writer, documentation-guardian, dynaplex-ef-analyzer, dynaplex-navigator, entity-refactoring-agent, mqtt-processor-specialist, test-engineer, ui-page-migration-specialist, ui-permission-migration-specialist
- haiku (5): component-scaffolder, config-validator, ef-core-model-formatter, pattern-enforcer, validation-modernizer
Skills
Skills provide contextual knowledge and procedures. They load reference material into the conversation without spawning a subagent.
| Skill | Auto-Trigger | Purpose |
|---|---|---|
| acsis-component-info | No | Component information: what each engine does, database references, architecture |
| acsis-sql | No | PostgreSQL database access: pgpass credentials, dynamic port discovery, psql queries |
| acsis-superset | No | Apache Superset analytics: dashboards, datasets, charts, REST API, SQL views |
| database-migrations | Yes | EF Core migrations using ./scripts/dplx db migrations add. Triggers on: "migration", "add migration", "create migration", "database change", "add table", "add column", "add index", "schema change", "DbContext", "EF Core", "dotnet ef", "dplx db" |
| dynaplex-diagnostics | No | Runtime troubleshooting: log analysis, connection debugging, performance issues |
| dynaplex-reference | No | Quick reference for Dynaplex patterns, navigation, configuration, code snippets |
| dynaplex-validation-tools | No | Pre-commit validation scripts: service lifetime errors, DateTimeOffset usage, MQTT config, naming conventions |
| e2e-testing | Yes | Playwright-based UI testing, database verification, documentation updates. Triggers on: "test the application", "verify functionality", "sniff test", "test end-to-end", "validate the UI" |
| microsoft-learn-usage | No | How to use the Microsoft Learn MCP server effectively for .NET development |
| ui-migration-orchestrator | No | Orchestrates full-stack UI page migrations, coordinating multiple specialist agents |
| ui-migration-patterns | No | Quick lookup of before/after UI migration code patterns without executing a migration |
Skills by Category
| Category | Skills |
|---|---|
| Development & Architecture | dynaplex-reference, acsis-component-info, microsoft-learn-usage |
| Database & Migrations | database-migrations, acsis-sql |
| Testing & Validation | e2e-testing, dynaplex-validation-tools, dynaplex-diagnostics |
| UI Migration | ui-migration-orchestrator, ui-migration-patterns |
| Analytics | acsis-superset |
Commands
Commands are slash commands (/command-name) that invoke focused workflows. Most delegate to a specialized agent.
| Command | Model | Purpose | Arguments |
|---|---|---|---|
| /add-mqtt-processor | haiku | Add MQTT processor to existing component | None |
| /check-architecture | sonnet | Verify Dynaplex architectural boundaries and compliance | None |
| /create-bead | haiku | Quickly create a Linear issue from a brief description | description (required) |
| /create-component | haiku | Scaffold a new Dynaplex component with complete structure | None |
| /diagnose-build | opus | Analyze build errors for common Dynaplex issues | None |
| /document-component | sonnet | Generate or update component documentation | None |
| /generate-journal-entity | haiku | Generate journal table entity class following ADR 035 | None |
| /generate-migration | -- | Create EF Core migration for pending changes (uses database-migrations skill) | None |
| /migrate-ui-page | opus | Migrate an AssetsTrack UI page to modern Dynaplex architecture | [page-name] (optional) |
| /modernize-validation | haiku | Refactor FluentValidation to Microsoft DataAnnotations | None |
| /review-patterns | sonnet | Check code against documented Dynaplex patterns | None |
| /signoff | -- | Agent signoff procedure: mail check, git merge, cleanup | None |
| /validate-config | haiku | Validate appsettings.json files for completeness and correctness | None |
Commands by Category
| Category | Commands |
|---|---|
| Code Generation | /create-component, /add-mqtt-processor, /generate-journal-entity |
| Database | /generate-migration |
| Validation & Review | /check-architecture, /review-patterns, /validate-config, /diagnose-build |
| Migration | /migrate-ui-page, /modernize-validation |
| Documentation | /document-component |
| Workflow | /signoff, /create-bead |
Hooks
Hooks are shell scripts that run automatically on specific events. They are not invoked manually.
| Hook | Event | Purpose |
|---|---|---|
| session-start.sh | SessionStart | Confirms agent identity, displays collaborators, recovers stashed work |
| precompact.sh | PreCompact | Stashes uncommitted work before context compaction |
| agent-signoff.sh | SessionEnd | Cleans up worktree processes and containers |
Decision Tree: Which Tool Should I Use?
Use this flowchart to pick the right tool for a given task.
START: What do you need to do?
│
├── I need INFORMATION (read-only)
│ ├── Quick code pattern or snippet? ──────────→ Skill: dynaplex-reference
│ ├── Component structure or file location? ───→ Agent: dynaplex-navigator
│ ├── Database schema or migration history? ───→ Agent: dynaplex-ef-analyzer
│ ├── .NET/Azure official documentation? ──────→ MCP: Microsoft Learn
│ ├── Component purpose and architecture? ─────→ Skill: acsis-component-info
│ └── Runtime diagnostics or logs? ────────────→ Skill: dynaplex-diagnostics
│
├── I need to CREATE something
│ ├── New component? ──────────────────────────→ Command: /create-component
│ ├── Database migration? ─────────────────────→ Command: /generate-migration
│ ├── MQTT processor? ─────────────────────────→ Command: /add-mqtt-processor
│ ├── Journal entity? ─────────────────────────→ Command: /generate-journal-entity
│ ├── Linear issue? ───────────────────────────→ Command: /create-bead
│ ├── Component documentation? ────────────────→ Command: /document-component
│ └── Tests? ──────────────────────────────────→ Agent: test-engineer
│
├── I need to REVIEW or VALIDATE
│ ├── Architecture compliance? ────────────────→ Command: /check-architecture
│ ├── Code patterns? ──────────────────────────→ Command: /review-patterns
│ ├── Configuration files? ────────────────────→ Command: /validate-config
│ ├── Build errors? ──────────────────────────→ Command: /diagnose-build
│ ├── Full code review? ──────────────────────→ Agent: code-reviewer-dynaplex
│ └── Pre-commit checks? ─────────────────────→ Skill: dynaplex-validation-tools
│
├── I need to MIGRATE or REFACTOR
│ ├── UI page to Dynaplex? ────────────────────→ Command: /migrate-ui-page
│ ├── Permissions to hierarchical? ────────────→ Agent: ui-permission-migration-specialist
│ ├── FluentValidation to DataAnnotations? ────→ Command: /modernize-validation
│ ├── Entity IDs from long to Guid? ──────────→ Agent: entity-refactoring-agent
│ └── EF Core model formatting? ──────────────→ Agent: ef-core-model-formatter
│
├── I need to FIX something
│ ├── Build errors? ──────────────────────────→ Command: /diagnose-build
│ ├── Service lifetime errors? ────────────────→ Agent: troubleshooter
│ ├── PostgreSQL DateTime issues? ─────────────→ Agent: troubleshooter
│ ├── MQTT session problems? ──────────────────→ Agent: troubleshooter
│ └── Runtime issues? ────────────────────────→ Skill: dynaplex-diagnostics
│
├── I need to TEST
│ ├── Write unit/integration tests? ──────────→ Agent: test-engineer
│ ├── End-to-end UI testing? ─────────────────→ Skill: e2e-testing
│ └── Database verification? ─────────────────→ Skill: acsis-sql
│
└── SESSION MANAGEMENT
├── End of session? ─────────────────────────→ Command: /signoff
├── Query the database? ─────────────────────→ Skill: acsis-sql
└── Superset dashboards? ────────────────────→ Skill: acsis-superset
Quick Rules
- Need info fast? Use a skill (loads reference material, no subagent overhead).
- Simple focused workflow? Use a command (one invocation, delegates automatically).
- Complex autonomous work? Use an agent (multi-step execution, deep expertise).
- Working with .NET? Always check Microsoft Learn MCP first for official patterns, then apply with agents.
Common Multi-Tool Workflows
| Workflow | Sequence |
|---|---|
| Database migration | ef-core-model-formatter → /generate-migration → dynaplex-ef-analyzer |
| Code review | pattern-enforcer → dynaplex-architect → code-reviewer-dynaplex |
| New MQTT component | /create-component → /add-mqtt-processor → /validate-config → /document-component |
| UI page migration | ui-migration-orchestrator skill → ui-page-migration-specialist agent → pattern-enforcer |
| Entity modernization | entity-refactoring-agent → /generate-migration → dynaplex-ef-analyzer |