---
title: "samuel"
description: "Personal indie hacker workflow: spec-driven pipeline with living journal, autonomous conductor, git, and project management skills"
canonical: https://agentpluginsdirectory.com/plugins/samuel
last-updated: 2026-09-25
---

# samuel
Personal indie hacker workflow: spec-driven pipeline with living journal, autonomous conductor, git, and project management skills
- Slug: samuel
- Publisher: Samuel Osuna
- Repository: https://github.com/samosunaz/agent-skills
- Manifest: plugins/samuel/plugin.json
- Version: 4.13.0
- License: MIT
- Category (editorial): productivity
- Skills: 43 (address-pr-comments, analyze, api-contract, api-request, cascade, codebase-documentation, conductor, coordinate, create-atomic-commit, create-constitution, create-review-md, debrief, done, feature-dossier, find-unknowns, iaas, implement, interrogate, kickoff, land, mermaid, motion-brief, next, plan, polish, pr-self-audit, premise, progress, refine-plan, remove-slop, repo-audit, retro, roadmap, session-handoff, spec, start-task, tdd, team-orchestrate, tldr, update-constitution, validate, wave-prep, waves)
- MCP servers: 0
- Stars: 0
- Repository created: 2026-08-06
- Repository last pushed: 2026-09-24
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/samuel
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What samuel does, in the publisher's words

> A skill registry and sub-agents for Claude Code and OpenAI Codex from one shared skill source, built for solo and indie hacker projects. A spec-driven pipeline with a living implementation journal, plus git and project-management skills. GitHub-native: work items are GitHub Issues carrying a human Brief + a self-contained Executor Plan, driven by an autonomous conductor that can ship draft PRs for headless/cloud runs. GitHub is the only tracker.

- Claude Code or Codex: both load this plugin.
- To run the pipeline in a project: the gh CLI, authenticated.
- Bun 1.2.4+ to work on this repo itself.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/samosunaz/agent-skills/HEAD/README.md

## Skills

- address-pr-comments: Triage, verify, and resolve incoming PR comments, apply fixes, reply, resolve threads, close each pass with a Resolution marker comment, re-request review. Incremental: scopes to feedback since the last pass. Author side of the PR review gate. Trigger on 'address pr comments', 'address review feed…
- analyze: Read-only cross-artifact consistency check across spec, research, plan, tasks, journal, and constitution. Severity-tagged findings, no auto-edits. Trigger on 'analyze', 'consistency check', before implementing a non-trivial feature.
- api-contract: Document an endpoint the backend built, for the client(s) that consume it, web frontend and/or native mobile (iOS/Android). Emits TS + Swift/Kotlin types. Output is an inline copy-paste block by default. Trigger on 'api contract', 'document endpoint', 'contract for frontend/mobile'.
- api-request: Spec an endpoint a client needs from the backend, from the web frontend OR native mobile (iOS/Android) perspective. Output is an inline copy-paste block by default. Trigger on 'api request', 'i need an endpoint', 'request endpoint', 'spec for backend', 'new endpoint from front/mobile'.
- cascade
- codebase-documentation: Document codebase as-is through parallel sub-agent research and synthesis. Use when user asks to understand, explore, or document how code works without making changes.
- conductor: Drive the pipeline unattended phase-by-phase. Can bootstrap from an item id, drive research→…→validate, and (in --ship mode) open a draft PR. Can be fired automatically by GitHub (schedule / issue-labeled), see reference/automated-trigger.md. Trigger on 'conductor', 'run pipeline', 'run the pipeli…
- coordinate: Coordinator mode for one task: own direction, decomposition and sign-off; hand every routine implementation to named Orca workers (Claude or Codex) launched with an explicit model and effort, a six-slot brief and a compact report contract; supervise without silent waits; integrate and verify in one…
- create-atomic-commit: Create git commits with user approval and no AI attribution. Reviews changes, plans atomic commits following conventional commits, and executes upon confirmation.
- create-constitution: Ratify the repo's CONSTITUTION.md (3-5 non-negotiable principles, semver, governance) at v1.0.0. Optional: the pipeline degrades gracefully without it. Trigger on 'create constitution', 'ratify principles', 'initial constitution'.
- create-review-md: Generate a repo's schema-v1 REVIEW.md: deterministic evidence digest (repo type, gate signals, CI job names, validation/journal findings, self-review history) + semantic derivation of repo-specific rules, cited per bullet. Existing REVIEW.md → --check conformance report only. Trigger on 'create re…
- debrief
- done: Close the loop: open a PR (Closes #N), mark the item done, and clean up. Supports --draft for autonomous runs. Trigger on 'done', 'finished', 'ship it', 'open the PR'.
- feature-dossier: Create or update a living feature dossier, enriched markdown + Mermaid diagrams/flows, in a versioned product catalog. For big features that change product behavior; reference for humans and AI before future modifications. Output language configurable (--lang, default es). Trigger on 'feature dos…
- find-unknowns
- iaas
- implement
- interrogate
- kickoff
- land
- mermaid
- motion-brief
- next
- plan
- polish
- pr-self-audit
- premise
- progress
- refine-plan
- remove-slop
- repo-audit
- retro
- roadmap
- session-handoff
- spec
- start-task
- tdd
- team-orchestrate
- tldr
- update-constitution
- validate
- wave-prep
- waves

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.