Skills

Reusable Agent Skills published by legout.

Install

Install one skill:

npx skills add legout/skills --skill systematic-debugging --global --agent pi --yes --copy

Install the complete catalog:

npx skills add legout/skills --skill '*' --global --agent pi --yes --copy

The catalog uses nested categories; skill names and /skill:<name> commands remain unchanged.

Catalog

Engineering

• deslop — broad evidence-driven codebase cleanup.
• modern-python — uv, Ruff, and ty setup or migration.
• simplify-code — behavior-preserving cleanup of settled changed code.
• systematic-debugging — reproducible root-cause diagnosis.

Skill authoring

• agent-md-refactor — concise agent instructions with scoped references.
• effective-agent-skills — Agent Skill authoring, review, and debugging.
• improve-skill — skill changes derived from agent-session evidence.
• workflow-from-chats — durable preferences mined across recent chats.

Tools and research

• chrome-cdp — approved control of an existing local Chrome session.
• handoff — redacted handoff for a fresh agent session.
• last30days — recent social, community, video, GitHub, and web research.
• research — primary-source research captured in a repository note.
• marimo-notebook — file-based marimo notebooks.
• marimo-pair — live marimo-kernel collaboration.
• pi-custom-model — explicit custom Pi model registration.
• terminal-session-control — explicit Herdr or cmux target interaction.

Visualization

• archify — standalone interactive HTML diagrams.
• drawio-skill — precise editable draw.io diagrams.
• excalidraw — sketch-like editable Excalidraw diagrams.

Workflow

• capture-project-vision — project vision and durable decisions.
• domain-modeling — active glossary and ADR maintenance.
• grilling — decision-tree stress testing, with optional domain docs.
• make-release — semver GitHub and optional PyPI releases.
• merge-worktree — worktree integration and cleanup.
• orchestrate-implementation — coordinated multi-task implementation.
• prototype-question — disposable code for one design question.
• review-codebase-architecture — read-only module and seam review.
• shape-design — approved bounded design before implementation.
• verification-before-completion — fresh evidence before success claims.
• write-implementation-plan — executable plans from approved requirements.

Writing

• doc-coauthoring — collaborative document discovery and drafting.
• documentation-writer — Diátaxis software documentation.
• humanizer — fact-preserving natural-language rewrites.

Boundaries

• deslop owns broad cleanup; simplify-code owns settled changed-code cleanup.
• documentation-writer owns document type and quality; doc-coauthoring owns collaborative drafting.
• marimo-notebook edits files; marimo-pair works through a live kernel.
• effective-agent-skills covers general authoring; improve-skill requires session evidence.
• improve-skill targets one skill/session; workflow-from-chats mines cross-cutting preferences across recent chats.
• research follows durable claims to primary sources; last30days measures recent community discussion and sentiment.
• review-codebase-architecture identifies candidates; shape-design settles one.
• grilling owns the stress-test interview; domain-modeling owns glossary and ADR updates; shape-design owns the approved design or specification.
• archify produces interactive HTML, drawio-skill produces precise editable diagrams, and excalidraw produces sketch-like canvases.

Workflow

review architecture ─┐
capture vision ──────┼─> shape design <-> domain modeling (glossary / optional ADR)
grilling ────────────┘          |
                               ├─ bounded design ───────────────────────> orchestrate -> merge
                               ├─ architectural spec -> thin plan ──────┤
                               └─ architectural spec -> tracker tickets ┘

shape design -> prototype spike -> shape design

unexpected failure -> systematic-debugging
completion claim   -> verification-before-completion

ADRs explain why; specifications define behavior and acceptance; plans define executable units. Tracker tickets replace—rather than duplicate—the plan when durable coordination is required.

orchestrate-implementation expects pi-subagents and may use configured pi-intercom peers. merge-worktree PR mode expects an authenticated gh CLI. make-release composes with release, changelog, GitHub, commit, and uv tooling when available.

Provenance

UPSTREAM_ADOPTION.md records adoption decisions. sources.json records pinned file-level provenance, and THIRD_PARTY_NOTICES.md carries applicable notices.

bash scripts/check-skill-sources.sh

Development

bash -n tests/skills_test.sh scripts/check-skill-sources.sh
bash tests/skills_test.sh
bash scripts/check-skill-sources.sh
git diff --check

License

Original material is MIT. Adopted material remains under the licenses listed in THIRD_PARTY_NOTICES.md.