Skip to content

mryll/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mryll/skills

A collection of agent skills for coding CLIs — Claude Code, Codex, Gemini CLI, Copilot, and others.

Skills are markdown-only instructions that shape how your coding agent writes, reviews, and architects code. No runtime dependencies, no build steps — just drop them in and go.

Skills | Installation | Usage

Skills

Skill Description
agentmd Generate a single canonical AGENTS.md plus minimal CLI-specific shims that @-import it for tools that don't read AGENTS.md natively (Claude Code, Gemini CLI, Qwen Code). Based on ETH Zurich research showing that auto-generated context files decrease performance while minimal human-written ones improve it.
low-complexity Automatically enforce low Cognitive Complexity (SonarSource) and Cyclomatic Complexity in all generated code. Activates on every code write/modify — no explicit trigger needed.
vertical-slice-architecture Organize code by feature/use-case instead of technical layers. Works with any language and app type (web API, CLI, event-driven, etc.).
codex-review Iterative code review debate between Claude Code and Codex CLI until both reach consensus. Supports plan-mode review with implementation contracts.
codex-discuss Iterative non-code debate between Claude Code and Codex CLI on any topic — diet, fitness, writing, decisions, strategy, brainstorming. Same iterative consensus mechanic as codex-review, adapted for open-ended subjects (content inline, no filesystem navigation).
test-namer Write expressive, behavior-focused tests following Vladimir Khorikov's testing principles. Plain English names, test behavior not implementation.
dual-testing Go dual testing strategy: integration tests (testcontainers) verify full-chain wiring for happy paths, unit tests (testify/mock) verify error handling logic. Avoids duplicating happy paths across layers.
explain-pr Explain a freshly opened Pull Request or Merge Request back to you in plain language — what changed, why, and how — with the relevant code snippets inline. Fixed, predictable structure; reads the local git diff, so no gh/glab required.
como-si-fuera-de-boca Explain anything — code, errors, concepts, or non-technical topics — in the simplest plain-language way (ELI5), with a natural Río de la Plata (Argentine) voice that puts clarity before humor. On-request only: triggers on "explicámelo como si fuera de Boca", "bajámelo un cambio", "en criollo", "ELI5", "explain like I'm 5", etc.

Installation

All skills

npx skills add mryll/skills

Individual skills

npx skills add mryll/skills --skill <skill-name>

For example:

npx skills add mryll/skills --skill low-complexity
npx skills add mryll/skills --skill codex-review

Tip

You can install multiple individual skills by running the command once per skill. Only install what you need — each skill is fully self-contained.

Usage

Once installed, skills activate automatically based on context. Some examples:

  • agentmd — Ask your agent to "generate CLAUDE.md" or "create AGENTS.md"
  • low-complexity — Activates automatically whenever code is written or modified
  • vertical-slice-architecture — Ask to "use vertical slice architecture" or start building features in a VSA project
  • codex-review — Ask to "review with codex" or "validate plan with codex"
  • codex-discuss — Ask to "discuss with codex", "iterate this with codex", or "get codex's take on this" (non-code topics: diet, fitness, writing, decisions, etc.)
  • test-namer — Activates whenever tests are written, created, or reviewed
  • dual-testing — Ask "where should this test go?" or activates when designing test strategy for a Go handler/feature
  • explain-pr — Ask to "explicame el PR/MR", "walk me through this PR", or run /explain-pr right after opening a PR/MR. Optional: to fire it automatically after every PR/MR, add a line like "when you create a PR/MR, invoke explain-pr" to your AGENTS.md/CLAUDE.md.
  • como-si-fuera-de-boca — Ask to "explicámelo como si fuera de Boca", "bajámelo un cambio", "explicalo simple", "en criollo", "ELI5", or "explain like I'm 5" when you want something dumbed down on request.

About

Portable agent skills for AI coding agents — works with Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor & GitHub Copilot: code review, vertical-slice architecture, Go testing strategy, low cognitive-complexity & AGENTS.md generation. Markdown-only — install with npx skills.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors