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

Trust tier 2
  • community
LLM review pending
Source check pending

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

Generates DDD Repository interfaces and implementation stubs for PHP 8.4. Creates domain interfaces in Domain layer, implementation in Infrastructure.

Install

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

SKILL.md

Repository Generator

Generate DDD-compliant Repository interfaces and implementation stubs.

Repository Characteristics

  • Interface in Domain: Contract defined in Domain layer
  • Implementation in Infrastructure: Doctrine/Eloquent/etc. implementation
  • Works with Aggregates: Not entities directly
  • Collection-like: Find, save, remove operations
  • No business logic: Only persistence operations

Generation Process

Step 1: Generate Interface

Path: src/Domain/{BoundedContext}/Repository/

  1. {AggregateRoot}RepositoryInterface.php — Domain contract
Step 2: Generate Implementation

Path: src/Infrastructure/Persistence/Doctrine/

  1. Doctrine{AggregateRoot}Repository.php — Doctrine implementation
Step 3: Generate In-Memory Repository (Optional)

Path: tests/Infrastructure/Persistence/

  1. InMemory{AggregateRoot}Repository.php — For unit testing
Step 4: Generate Integration Tests

Path: tests/Integration/Infrastructure/Persistence/


File Placement

ComponentPath
Interfacesrc/Domain/{BoundedContext}/Repository/
Doctrine Implsrc/Infrastructure/Persistence/Doctrine/
In-Memorytests/Infrastructure/Persistence/
Integration Teststests/Integration/Infrastructure/Persistence/

Naming Conventions

ComponentPatternExample
Interface{AggregateRoot}RepositoryInterfaceOrderRepositoryInterface
Doctrine ImplDoctrine{AggregateRoot}RepositoryDoctrineOrderRepository
In-MemoryInMemory{AggregateRoot}RepositoryInMemoryOrderRepository

Quick Template Reference

Interface
php
interface {AggregateRoot}RepositoryInterface
{
public function findById({AggregateRoot}Id $id): ?{AggregateRoot};
public function save({AggregateRoot} $aggregate): void;
public function remove({AggregateRoot} $aggregate): void;
public function nextIdentity(): {AggregateRoot}Id;
}
Doctrine Implementation
php
final readonly class Doctrine{AggregateRoot}Repository implements {AggregateRoot}RepositoryInterface
{
public function __construct(
private EntityManagerInterface $em
) {}
public function findById({AggregateRoot}Id $id): ?{AggregateRoot}
{
return $this->em->find({AggregateRoot}::class, $id->value);
}
public function save({AggregateRoot} $aggregate): void
{
$this->em->persist($aggregate);
$this->em->flush();
}
public function remove({AggregateRoot} $aggregate): void
{
$this->em->remove($aggregate);
$this->em->flush();
}
public function nextIdentity(): {AggregateRoot}Id
{
return {AggregateRoot}Id::generate();
}
}
In-Memory Implementation
php
final class InMemory{AggregateRoot}Repository implements {AggregateRoot}RepositoryInterface
{
private array $items = [];
public function findById({AggregateRoot}Id $id): ?{AggregateRoot}
{
return $this->items[$id->value] ?? null;
}
public function save({AggregateRoot} $aggregate): void
{
$this->items[$aggregate->id()->value] = $aggregate;
}
public function clear(): void
{
$this->items = [];
}
}

Design Rules

RuleGoodBad
Layer PlacementInterface in DomainInterface in Infrastructure
Aggregate ScopeRepository per aggregate rootRepository per entity
Query MethodsSimple filtersBusiness logic in queries
IdentitynextIdentity() methodExternal ID generation

Anti-patterns to Avoid

Anti-patternProblemSolution
Entity RepositoryBypasses aggregateOnly aggregate roots
Business QueriesLogic in repositoryUse Specification pattern
Infrastructure LeakDomain depends on ORMInterface in Domain
Generic RepositoryToo abstractSpecific per aggregate
Missing nextIdentityCan't generate IDsAdd to interface

References

For complete PHP templates and examples, see:

  • references/templates.md — Interface, Doctrine, In-Memory, Test templates
  • references/examples.md — Order, User repositories with Doctrine and In-Memory implementations

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

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

Source

Popularity

Repository stars
101
Repository forks
26
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-repository/badge)](https://verified-skill.com/skills/dykyi-roman/awesome-claude-code/create-repository)

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