xonecas.io
64875
Mc

mini-coder / commit 1cced36

docs: mention custom agents, skills, and .agents conventions in README

Sean2026-02-25 1cced3671d4b0f9c4443fa36e8390abeff0aa780 parent b896840

1 file changed

README.md+20−1
@@ -55,6 +55,8 @@ I can also connect to **MCP servers** (like Exa for web search), giving you supe
5555 - **Shell integration** — prefix with `!` to run shell commands inline. Use `@` to reference files in your prompt (with Tab completion).
5656 - **Slash commands** — `/model` to switch models, `/plan` for read-only thinking mode, `/ralph` for autonomous looping, `/review` for a code review, `/undo` to roll back a turn, `/new` for a clean session, `/mcp` to manage MCP servers. See all with `/help`.
5757 - **Custom commands** — drop a `.md` file in `.agents/commands/` and it becomes a `/command`. Supports argument placeholders (`$ARGUMENTS`, `$1`…`$9`) and shell interpolation (`` !`cmd` ``). Global commands live in `~/.agents/commands/`. Custom commands take precedence over built-ins. → [docs/custom-commands.md](docs/custom-commands.md)
58+- **Custom agents** — drop a `.md` file in `.agents/agents/` (or `~/.agents/agents/` globally) and reference it with `@agent-name` in your prompt. The agent runs in its own context window with a custom system prompt and optional model override. → [docs/custom-agents.md](docs/custom-agents.md)
59+- **Skills** — place a `SKILL.md` in `.agents/skills/<name>/` and inject it into any prompt with `@skill-name`. Skills are *never* auto-loaded — always explicit. → [docs/skills.md](docs/skills.md)
5860 - **Post-tool hooks** — drop an executable at `.agents/hooks/post-<tool>` and I'll run it after every matching tool call.
5961 - **Beautiful, minimal output** — diffs for edits, formatted trees for file searches, a live status bar with model, git branch, and token counts.
6062 - **16 ANSI colors only** — my output inherits *your* terminal theme. Dark mode, light mode, Solarized, Gruvbox — I fit right in.
@@ -65,12 +67,29 @@ I can also connect to **MCP servers** (like Exa for web search), giving you supe
6567
6668 - **I eat my own dog food.** I was built *by* a mini-coder agent. It's agents all the way down. 🐢
6769 - **I'm tiny but mighty.** The whole runtime is [Bun.js](https://bun.com) — fast startup, native TypeScript, and a built-in SQLite driver.
68-- **I respect existing conventions.** Hook scripts live in `.agents/hooks/`, context in `AGENTS.md` or `CLAUDE.md` — I follow the ecosystem instead of inventing new standards.
70+- **I respect existing conventions.** Hook scripts live in `.agents/hooks/`, context in `AGENTS.md` or `CLAUDE.md`, commands in `.agents/commands/`, agents in `.agents/agents/`, skills in `.agents/skills/` — I follow the ecosystem instead of inventing new standards.
6971 - **I spin while I think.** ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ (It's the little things.)
7072 - **I can clone myself.** The `subagent` tool lets me spin up parallel instances of myself to tackle independent subtasks simultaneously. Divide and conquer! (Up to 3 levels deep.)
7173
7274 ---
7375
76+## 📁 The `.agents` folder
77+
78+mini-coder follows the [`.agents` convention](https://github.com/agentsmd/agents) used across the AI coding tool ecosystem. Drop files in `.agents/` to extend behaviour for the current repo, or `~/.agents/` to apply them globally.
79+
80+| Path | What it does |
81+|---|---|
82+| `.agents/commands/*.md` | Custom slash commands (`/name`) |
83+| `.agents/agents/*.md` | Custom agents (`@name`) |
84+| `.agents/skills/<name>/SKILL.md` | Reusable skill instructions (`@name`) |
85+| `.agents/hooks/post-<tool>` | Scripts run after a tool call |
86+| `AGENTS.md` | Project context injected into every system prompt |
87+
88+Local always overrides global. The same `~/.agents/` folder is shared with Claude Code, Opencode, and other compatible tools — skills and agents you write once work everywhere.
89+
90+---
91+
92+
7493 ## 🚀 Getting Started
7594
7695 ```bash