Skip to content

mryll/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 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.

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.

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