# Craft Action

> Crafting an Action. The heart of business logic.

- Skill: `attac-t/craft-action` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add attac-t/craft-action`
- Raw SKILL.md: https://api.skillmd.com/api/skills/attac-t/craft-action/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: attac-t (https://skillmd.com/u/attac-t)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/attac-t/craft-action

---


# Skill: Craft Action

> "An Action is a single unit of business logic."

## The Standard

1. **One Public Method**: `execute()`.
2. **Return Type**: Model or void. Never DTO or Response.
3. **Inject Actions**: Use `__construct` for dependencies.
4. **Accept Data**: DTOs or primitives in `execute()`.
5. **Fluent Chaining**: Store input on `$this`, chain private methods. Never pass params between them.

## The Anti-Patterns

| ❌ Don't                       | ✅ Do                          | Why                       |
|-------------------------------|-------------------------------|---------------------------|
| `DB::transaction()` in Action | Transaction in Controller     | Prevents composition      |
| Validate in Action            | Validate in FormRequest       | Single responsibility     |
| Wrap `Model::create()` only   | Add real logic or skip Action | No value added            |
| Return DTO/Response           | Return Model or void          | Actions aren't HTTP-aware |
| Pass params to private methods| Store on `$this`, chain methods| Verbose signatures, no fluency|

## Real-World Examples

See [examples/](examples/).