dykyi-roman/awesome-claude-code/create-command

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Generates CQRS Commands and Handlers for PHP 8.4. Creates immutable command DTOs with handlers that modify state. Includes unit tests.

Install

npx vskill@latest install dykyi-roman/awesome-claude-code/create-command

SKILL.md

Command Generator

Generate CQRS-compliant Commands and Command Handlers with tests.

Command Characteristics

  • Immutable: final readonly class
  • Imperative naming: Verb + noun (CreateOrder, ConfirmPayment)
  • Self-validating: Validates invariants in constructor
  • Intent-revealing: Name describes what should happen
  • Returns void or ID: Never returns data

Generation Process

Step 1: Generate Command

Path: src/Application/{BoundedContext}/Command/

  1. {Name}Command.php — Immutable command DTO
Step 2: Generate Handler

Path: src/Application/{BoundedContext}/Handler/

  1. {Name}Handler.php — Command processor
Step 3: Generate Tests

Path: tests/Unit/Application/{BoundedContext}/


File Placement

ComponentPath
Commandsrc/Application/{BoundedContext}/Command/
Handlersrc/Application/{BoundedContext}/Handler/
Unit Teststests/Unit/Application/{BoundedContext}/

Command Naming Conventions

ActionCommand NameReturns
Create newCreateOrderCommandID
Confirm/ApproveConfirmOrderCommandvoid
Cancel/RejectCancelOrderCommandvoid
Update propertyUpdateShippingAddressCommandvoid
Add childAddOrderLineCommandvoid
Remove childRemoveOrderLineCommandvoid

Quick Template Reference

Command
php
final readonly class {Name}Command
{
public function __construct(
public {ValueObject} $id,
public string $data
) {
if (empty($data)) {
throw new \InvalidArgumentException('Data is required');
}
}
public static function fromArray(array $data): self
{
return new self(
id: new {ValueObject}($data['id']),
data: $data['data']
);
}
}
Handler (Update Flow)
php
final readonly class {Name}Handler
{
public function __construct(
private {Repository}Interface $repository,
private EventDispatcherInterface $events
) {}
public function __invoke({Name}Command $command): void
{
$aggregate = $this->repository->findById($command->id);
if ($aggregate === null) {
throw new NotFoundException($command->id);
}
$aggregate->doSomething($command->data);
$this->repository->save($aggregate);
foreach ($aggregate->releaseEvents() as $event) {
$this->events->dispatch($event);
}
}
}
Handler (Create Flow)
php
public function __invoke(CreateCommand $command): AggregateId
{
$aggregate = Aggregate::create(
id: $this->repository->nextIdentity(),
...
);
$this->repository->save($aggregate);
foreach ($aggregate->releaseEvents() as $event) {
$this->events->dispatch($event);
}
return $aggregate->id();
}

Anti-patterns to Avoid

Anti-patternProblemSolution
Returning DataQuery through commandUse Query for reads
No ValidationInvalid commandsValidate in constructor
Business LogicHandler has decisionsDelegate to aggregate
Missing EventsEvents not dispatchedAlways dispatch after save
Direct PersistenceBypassing aggregateAlways use aggregate methods

References

For complete PHP templates and examples, see:

  • references/templates.md — Command, Handler, Test templates with patterns
  • references/examples.md — CreateOrder, ConfirmOrder, CancelOrder examples and tests

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
96
Repository forks
25
7-day trend score
23

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/dykyi-roman/awesome-claude-code/create-command/badge)](https://verified-skill.com/skills/dykyi-roman/awesome-claude-code/create-command)

Something wrong with this skill or its page? Tell us.