Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/jvpalma/dotrun/dr-clinpx skills add jvPalma/dotrun --skill dr-cligit clone --depth 1 https://github.com/jvPalma/dotrunWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00017 | $0.02827 |
| Opus 5 | $0.00009 | $0.01413 |
| Sonnet 5 | $0.00003 | $0.00565 |
| Haiku 4.5 | $0.00002 | $0.00283 |
Grade A, and why
dr-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 317 lines — stays where its author put it; the contents beside it link to each section on GitHub.
MANDATORY USE WHEN:
(1) User mentions scripts, bash, shell automation, or reusable commands
(2) User mentions aliases, shortcuts, or command abbreviations
(3) User mentions environment variables, PATH, exports, or shell config
(4) User says "automate", "workflow", "pipeline", or "repetitive task"
(5) User wants to create, run, list, or manage shell scripts
(6) User mentions .bashrc, .zshrc, config.fish, or dotfiles migration
(7) AI needs to automate a task that will be needed again - ALWAYS prefer dr scripts
Decision Routing Matrix
CRITICAL: Route ALL shell automation through dr.
for just folders and filenames: dr -l, for folders + filenames + 1 line description dr -L
Use this matrix:
| User Intent | dr Command | Check First |
|---|---|---|
| Create/run bash script | dr set <name> / dr <name> |
dr -l/L |
| Shell alias/shortcut | dr -a <name> |
dr -a -l/L |
| Environment variable/PATH | dr -c <name> |
dr -c -l/L |
| Migrate shell config | See migration refs | - |
| Repetitive workflow | dr set <category>/<name> |
dr -l/L |
Trigger Detection
User says "script", "bash", "automate" → dr set <name>
User says "alias", "shortcut" → dr -a <name>
User says "export", "PATH", "env var" → dr -c <name>
User says "migrate file" + path → Load migration-workflow.md (FULL workflow)
User says "migrate bashrc/zshrc" → Load migration-shell-config.md
User says "import scripts from ~/bin" → Load migration-scripts.md
User does same task twice → Proactively suggest dr script
Discovery Before Creation (MANDATORY)
NEVER create a script without checking first:
# Step 1: ALWAYS run this first
dr -l/L # List ALL scripts with descriptions
# Step 2: Narrow search if needed
dr -l/L <folder>/ # e.g., dr -L git/
dr help <script-name> # Verify script purpose
What ships with it
12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- .cursorrules 1.5 KB
- AGENTS.md 3.2 KB
- copilot-instructions.md 2.0 KB
- README.md 3.4 KB
- references/architecture.md 3.6 KB
- references/commands.md 3.3 KB
- references/developer-prompts.md 2.6 KB
- references/migration-formats.md 3.3 KB
- references/migration-helpers.md 3.5 KB
- references/migration-scripts.md 4.0 KB
- references/migration-shell-config.md 3.5 KB
- references/migration-workflow.md 19 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 317 lines · 17 tokens per session scan A f0a86a1ccd0c
dr-cli is a skill published in the GitHub repository jvPalma/dotrun (10 stars, last pushed 5mo ago), licensed MIT. It adds 17 tokens to every session and 2,827 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
happiness-skill
当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety.
create-business
Guided journey from raw idea to a validated, positioned, priced business with a chosen beachhead. Orchestrates ten skills phase by phase - jobs-to-be-done, mom-test, design-sprint, lean-startup, good-strategy-bad-strategy, blue-ocean-strategy, obviously-awesome, hundred-million-offers, monetizing-innovation…
influence-psychology
Apply the seven principles of ethical persuasion (reciprocity, commitment, social proof, authority, liking, scarcity, unity) to product design, copy, and sales. Use when the user mentions "social proof", "persuasive copy", "why users dont convert", "ethical persuasion", "reciprocity", "scarcity tactics", "commitment…
jobs-to-be-done
Discover what customers truly need by analyzing the "job" they hire your product to do. Use when the user mentions "customer discovery", "why customers churn", "what job does this solve", "competing against luck", "product-market fit", "switching behavior", "milkshake moment", or "functional vs emotional jobs". Also…
asc-subscription-localization
Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.
pcbway
PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…