Skills

Reusable agent skills for coding, writing, research, and slide work. This repo is organized for Codex-first workflows and can also be installed as a standard skills repo.

🚀 Quick Start

Install the collection:

npx skills add narumiruna/skills

Then open Codex and run /skills to inspect what was installed. Invoke a skill explicitly with $skill-name, or describe the task normally and let Codex choose a match.

📦 Install

Standard install with npx skills

Use this when you want the collection without linking a local checkout:

npx skills add narumiruna/skills

Standard discovery exposes active skills only; deprecated skills live outside skills/ and remain available solely for repository reference or explicit local use.

🧭 How To Use In Codex

  • Run /skills to inspect the installed collection.
  • Type $managing-python-with-uv, $applying-imrad, or another skill name to invoke one explicitly.
  • Describe the task normally and let Codex choose a matching skill.

If Codex does not pick up a local skill change, restart Codex and try again.

🧰 Skill Catalog

Python

Repository path: skills/python/

Skill Use it for
managing-python-with-uv uv-based projects, scripts, dependencies, quality gates, and packaging.
building-typer-clis Typer command structure, options, and multi-command apps.
configuring-python-logging stdlib logging and loguru configuration choices.
using-peewee-orm Peewee patterns, scoped transactions, and SQLite tests.

Writing & Research

Repository path: skills/writing-research/

Skill Use it for
writing-plans Lean implementation plans with executable task lists and completion checks.
grilling-designs One-question-at-a-time plan and design grilling.
applying-imrad IMRaD fit checks, drafting, transformation, and review.
researching-gourmet-venues Evidence-based dining research with scoring and audit files.
creating-telegraph-pages Publishing structured public articles to Telegra.ph.

Learning & Explanation

Repository path: skills/learning-explanation/

Skill Use it for
explaining-step-by-step Progressive, source-grounded explanations of concepts, issues, PRs, code, systems, and decisions.

UI/UX Design

Repository path: skills/ui-ux-design/

Skill Use it for
designing-user-interfaces HIG-informed, accessible interfaces that preserve agency and useful capability.

Slides & Visuals

Repository path: skills/slides-visuals/

Skill Use it for
creating-slide-decks End-to-end Marp/Marpit slide creation.
authoring-marp-slides Marp/Marpit directives, layouts, and authoring rules.
designing-slide-colors Slide palettes and color-system workflows.
creating-svg-illustrations SVG diagrams and illustrations for decks.
creating-mermaid-diagrams Mermaid flowcharts, sequence diagrams, ER diagrams, and more.

Workflow & Repository Maintenance

Repository path: skills/workflow-repository/

Skill Use it for
creating-agent-skills Creating concise, valid, discoverable agent skills.
reviewing-code Read-only code review with conditional handoff for authorized code-path hardening.
resolving-pr-review-comments Explicitly invoked PR feedback assessment, fixes, replies, commits, and pushes.
hardening-code-paths Finding, fixing, and verifying plausible edge cases and failure modes in code paths.
naming-agent-skills Predictable, searchable skill names.
using-jira-cli Jira setup, queries, mutations, epics, sprints, releases, projects, and boards.
applying-tdd TDD red-green-refactor workflow for non-trivial code changes.
writing-git-commits Focused Conventional Commits from real diffs.
syncing-main-branch Explicitly invoked clean switch to main and protected fast-forward update.
managing-git-worktrees Safe Git worktree creation, repair, removal, pruning, and branch cleanup.
maintaining-memory-md Creates repository MEMORY.md on the first durable GOTCHA or TASTE, then keeps entries concise and current.
writing-agents-md Creating or updating repository AGENTS.md guidance.

🗄️ Deprecated Skills

Deprecated skills remain in deprecated/<skill-name>/ for reference and are excluded from standard discovery.

Skill Notes
checking-cli-help Deciding whether to inspect --help, built-in help, or man.
cleaning-atuin-history Preview-first cleanup planning for noisy Atuin shell history.
building-codex-hooks Codex CLI hooks and hooks.json behavior.
writing-work-logs Explicitly invoked work logs from repository evidence.