yap

Files (51)

• yap.md · .agents/rules/
• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• yap.md · .clinerules/
• plugin.json · .codex-plugin/
• yap.mdc · .cursor/rules/
• CONTRIBUTING.md · .github/
• copilot-instructions.md · .github/
• marketplace.json · .github/plugin/
• plugin.json · .github/plugin/
• test.yml · .github/workflows/
• .gitignore
• yap.md · .kiro/steering/
• yap-learn.md · .opencode/command/
• yap-review.md · .opencode/command/
• index.js · .opencode/plugins/
• yap.mjs · .opencode/plugins/
• plugin.json · .qoder-plugin/
• yap.md · .qoder/rules/
• yap.md · .windsurf/rules/
• AGENTS.md
• CLAUDE.md
• GEMINI.md
• INSTALL.md
• LICENSE
• README.md
• SKILL.md
• yap-learn.toml · commands/
• yap-review.toml · commands/
• corrections.md
• agent-portability.md · docs/
• skills.md · docs/
• README.md · examples/
• bash-backup.md · examples/
• python-csv-sum.md · examples/
• ui-card-radius.md · examples/
• gemini-extension.json
• opencode.json
• package.json
• yap.md · rules/
• check-rule-copies.sh · scripts/
• check-skills.sh · scripts/
• check-versions.sh · scripts/
• check.sh · scripts/
• link-skills.sh · scripts/
• list-skills.sh · scripts/
• set-version.sh · scripts/
• sync-rules.py · scripts/
• uninstall.sh · scripts/
• plugin.test.mjs · tests/
• run.sh · tests/

SKILL.md (first lines)

# yap

## routing

load the matching sub-skill, then follow it. more than one can apply.

| task | skill |
|---|---|
| any code | `yap-code` |
| rust | `yap-rust` |
| python | `yap-python` |
| bash | `yap-bash` |
| c | `yap-c` |
| markdown, readmes, docs | `yap-docs` |
| web, compose, tui, egui, quickshell ui | `yap-ui` |
| git, commits, prs, planning | `yap-workflow` |
| review, critique, debug | `yap-review` |
| search, research, summaries | `yap-research` |
| corrections, improving these skills | `yap-learn` |

<!-- rules:start -->
one-line goal: minimal, performant, adaptive output in your personal style, no generic filler.

## global

| rule | detail |
|---|---|
| no em-dashes | never, in code, comments, strings, docs or chat |
| tables first | more than one item means a table, not prose or long bullets |
| short | cut intros, outros, recaps, filler |
| adaptive | match the existing codebase style before applying these rules |
| minimal | fewest lines, abstractions and files that stay readable |
| performant | no needless allocs, copies or passes, no premature tuning |
| deps | use a library when it replaces real code, inline trivial helpers |

## task flow

| step | rule |
|---|---|
| start | ask clarifying questions before doing any work |
| work | smallest diff that solves it |
| code delivery | code plus a 1-2 line summary |
| end | table of what changed (file, change) |

## comments

- short phrases, never full sentences
- no capital at the start
- only where the why is not obvious

## avoid

- long generic documentation nobody reads
- comments that restate the code
- needless abstractions, wrappers and speculative features
- tests beyond tricky logic

## skills

harnesses with skill support load skills/<name>/SKILL.md for the task (yap-code, yap-rust, yap-python, yap-bash, yap-c, yap-ui, yap-docs, yap-workflow, yap-review, yap-research, yap-learn).
<!-- rules:end -->

From plgbrlism/yap, MIT.

More from plgbrlism/yap