@aiiware/aii 0.5.3 → 0.6.0

package/README.md

@@ -69,6 +69,8 @@ In agent mode, use these commands:
 /memory reload     Hot-reload instructions without restart
 /hooks             View configured hooks
 /hooks reload      Hot-reload hooks without restart
+/skills            List available skills
+/commit            Generate commit message and commit
 /exit              Exit the session
 ```
 
@@ -227,6 +229,74 @@ Extend agent behavior with custom scripts. Create `.aii/hooks.json` to run scrip
 
 Hooks let you add validation, logging, or approval gates. See the [hooks documentation](https://aiiware.com/docs/hooks) for details.
 
+## Skills (v0.6.0)
+
+Skills are reusable agent prompts that extend Aii with specialized capabilities.
+
+### Invoking Skills
+
+**Slash commands** (explicit):
+
+```bash
+/commit              # Generate commit message and execute
+/commit --dry-run    # Preview commit message only
+/review-pr 123       # Review a pull request
+```
+
+**Natural language** (the agent invokes skills automatically):
+
+```text
+> commit my changes
+> review the latest PR
+> generate a commit message for these updates
+```
+
+### Built-in Skills
+
+| Skill        | Description                              |
+|--------------|------------------------------------------|
+| `/commit`    | Generate conventional commit messages    |
+| `/review-pr` | Review PRs with quality checklist        |
+
+### Installing Skills
+
+Install skills from GitHub repositories:
+
+```bash
+# Shorthand format (owner/repo/skill-name)
+/skills install aiiware/skills/code-review    # Install to project (.aii/skills/)
+/skills install aiiware/skills/refactor --user # Install globally (~/.aii/skills/)
+
+# Absolute GitHub URL format
+/skills install https://github.com/aiiware/skills/tree/main/code-review
+/skills install https://github.com/aiiware/skills/tree/main/refactor --user
+
+# Management commands
+/skills uninstall code-review                  # Uninstall a skill
+/skills                                        # List all skills
+```
+
+**Shorthand format**: `owner/repo/skill-name` resolves to `github.com/owner/repo/skill-name/SKILL.md`
+
+**URL format**: Use absolute GitHub URLs when you need to install from a specific branch or path.
+
+### Creating Custom Skills
+
+Create skills in `.aii/skills/my-skill/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: Does something useful
+allowed-tools: Bash Read Grep
+---
+
+# My Skill
+
+Instructions for the agent...
+Use $ARGUMENTS for user input.
+```
+
 ## System Commands
 
 ```bash
@@ -244,6 +314,7 @@ aii --version      # Show version
 - **Multiple Providers**: Claude, GPT, Gemini, DeepSeek
 - **Prompt Templates**: Pre-built templates for common tasks
 - **Project Instructions**: Teach the agent your conventions with AGENTS.md
+- **Skills System**: Extend with reusable agent skills (`/commit`, `/review-pr`)
 - **Input History**: Navigate previous inputs with arrow keys
 - **Cancellation**: Press Esc to cancel any request