Skip to content

Commit f6e93c4

Browse files
committed
fix erroneous specification of 'skill'
Claude Code created a slash command for loading additional guidance, but called it a Skill, and didn't notice at the time. No, we have a slash command, call it such.
1 parent 2385535 commit f6e93c4

File tree

4 files changed

+28
-22
lines changed

4 files changed

+28
-22
lines changed

AGENTS.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -228,29 +228,29 @@ response shapes) may change incompatibly across any release, including patch
228228
versions. Clients must discover schemas at runtime via the MCP `tools/list`
229229
method rather than hard-coding parameter knowledge.
230230

231-
#### Server instructions and the companion skill
231+
#### Server instructions and the companion slash command
232232

233233
The MCP server returns an `instructions` field in its `InitializeResult`,
234234
providing discovery guidance and key usage patterns (when to reach for these
235235
tools, summary-mode and pagination hints). Clients that support the MCP
236236
`instructions` field (e.g. Claude Code's Tool Search) use this to decide when
237237
to search for the Unicode tools without needing any extra configuration.
238238

239-
For Claude Code specifically, a companion **skill** file
240-
[`extra/SKILL.md`](extra/SKILL.md) can be installed as
241-
`~/.claude/commands/character-unicode.md`. The skill provides a deeper
239+
For Claude Code specifically, a companion **slash command** file
240+
[`extra/character-unicode.md`](extra/character-unicode.md) can be installed as
241+
`~/.claude/commands/character-unicode.md`. The slash command provides a deeper
242242
reference — the tool-routing decision table, the full property field table, and
243243
advanced tips — and is loaded on demand (via `/character-unicode`) rather than
244244
occupying context in every conversation. The server's `instructions` text
245-
references the skill so that clients aware of it can load the detailed guide
246-
when needed.
245+
references the slash command so that clients aware of it can load the detailed
246+
guide when needed.
247247

248248
The two layers are designed to be complementary:
249249

250250
| Layer | Always loaded? | Content |
251251
|---|---|---|
252252
| `instructions` (in server) | Yes (via MCP init) | Discovery triggers, brief usage patterns |
253-
| Skill (`extra/SKILL.md`) | No (on demand) | Decision table, property field reference, tips |
253+
| Slash Command (`extra/character-unicode.md`) | No (on demand) | Decision table, property field reference, tips |
254254

255255
#### Exposed MCP tools
256256

README.md

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Patches welcome.
7474

7575
The `agent` sub-command tree has commands designed for AI coding agents and
7676
other automated tooling. All agent output is stable, machine-readable JSON.
77-
AIs should see [`AGENTS.md`](AGENTS.md) for full tool schemas and usage patterns.
77+
AIs should see [`AGENTS.md`]() for full tool schemas and usage patterns.
7878

7979
`character agent mcp` starts a [Model Context Protocol][mcp] stdio server.
8080
This allows `character` to act as a co-process providing Unicode domain
@@ -108,20 +108,20 @@ The server returns an `instructions` field in its MCP initialize response,
108108
which Claude Code uses to discover the Unicode tools automatically via Tool
109109
Search — no additional configuration is needed for basic usage.
110110

111-
**Installing the skill file** (optional): the file
112-
[`extra/SKILL.md`](extra/SKILL.md) provides a deeper reference — a
111+
**Installing the custom slash command** (optional): the file
112+
[`extra/character-unicode.md`]() provides a deeper reference — a
113113
tool-routing decision table, the full property field reference, and advanced
114114
tips. Install it as a custom slash command for on-demand access:
115115

116116
```sh
117117
# from the character source tree
118-
mkdir -p ~/.claude/commands
119-
cp extra/SKILL.md ~/.claude/commands/character-unicode.md
118+
mkdir -pv ~/.claude/commands
119+
cp -v extra/character-unicode.md ~/.claude/commands/./
120120
```
121121

122122
Once installed, type `/character-unicode` in a Claude Code session to load the
123-
skill into context. The server's `instructions` text references the skill, so
124-
Claude can load it when detailed guidance is needed.
123+
extra guidance into context. The server's `instructions` text references the
124+
command, so Claude can load it when detailed guidance is needed.
125125

126126
#### Other MCP clients
127127

@@ -134,12 +134,18 @@ automatically.
134134

135135
## Documentation
136136

137-
| File | Audience |
138-
| ---------------------------------- | ---------------------------------------------------------------------------- |
139-
| [`AGENTS.md`](AGENTS.md) | AI agents — tool schemas, example invocations, output formats |
140-
| [`CODE_GUIDE.md`](CODE_GUIDE.md) | Developers — package map, reading order, data flow, protocols |
141-
| [`extra/SKILL.md`](extra/SKILL.md) | AI agents — tool-routing table, property field reference, Claude Code skill |
142-
137+
| File | Audience |
138+
| -------------------------------- | ----------------------------------------------------------------------------------- |
139+
| [`AGENTS.md`]() | AI agents — tool schemas, example invocations, output formats |
140+
| [`CODE_GUIDE.md`]() | Developers — package map, reading order, data flow, protocols |
141+
| [`extra/character-unicode.md`]() | AI agents — tool-routing table, property field reference, Claude Code slash command |
142+
143+
[AGENTS.md]: AGENTS.md
144+
[`AGENTS.md`]: AGENTS.md
145+
[CODE_GUIDE.md]: CODE_GUIDE.md
146+
[`CODE_GUIDE.md`]: CODE_GUIDE.md
147+
[extra/character-unicode.md]: extra/character-unicode.md
148+
[`extra/character-unicode.md`]: extra/character-unicode.md
143149

144150
## Building
145151

commands/agent/mcpserver/server.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Key patterns:
5050
- Block names accept partial case-insensitive matches; call unicode_list_blocks first if unsure of exact spelling.
5151
- Property objects include language-specific escape sequences (JSON, Rust, C, URL-encoded) ready for direct insertion into source code.
5252
53-
For detailed usage guidance, invoke the /character-unicode skill if available.`
53+
For detailed usage guidance, invoke the /character-unicode slash command if available.`
5454

5555
// ServeStdio starts the MCP server on os.Stdin / os.Stdout.
5656
func (s *Server) ServeStdio(ctx context.Context) error {

extra/SKILL.md renamed to extra/character-unicode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# character — Unicode MCP Tool Skill
1+
# character — Unicode MCP Tool Slash Command
22

33
Detailed usage guide for the `character` MCP server's Unicode tools.
44
This supplements the server's built-in `instructions` field (which covers

0 commit comments

Comments
 (0)