othmanadi--planning-with-files
wehub-resource-sync
96 行
2.7 KiB
Markdown
96 行
2.7 KiB
Markdown
# Autohand Code Setup
|
|
|
|
How to use planning-with-files with [Autohand Code](https://github.com/autohandai/code-cli/).
|
|
|
|
---
|
|
|
|
## What This Integration Adds
|
|
|
|
- Standard Agent Skill loading through Autohand Code skill discovery.
|
|
- Full templates, scripts, and reference documentation from the canonical skill.
|
|
- User-level or project-level installs.
|
|
|
|
Autohand Code discovers skills from multiple locations, including:
|
|
|
|
1. **User-level skills:** `~/.autohand/skills/`
|
|
2. **Project-level skills:** `<project>/.autohand/skills/`
|
|
3. **Shared Agent Skills:** `~/.agents/skills/`
|
|
|
|
---
|
|
|
|
## Installation (standard Agent Skills)
|
|
|
|
Install with the shared Agent Skills installer:
|
|
|
|
```bash
|
|
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
|
|
```
|
|
|
|
This installs into the shared Agent Skills convention that Autohand Code can scan.
|
|
|
|
---
|
|
|
|
## Installation (Autohand-native user scope)
|
|
|
|
Install just for your user account:
|
|
|
|
```bash
|
|
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
|
|
mkdir -p ~/.autohand/skills
|
|
cp -r /tmp/planning-with-files/skills/planning-with-files ~/.autohand/skills/
|
|
rm -rf /tmp/planning-with-files
|
|
```
|
|
|
|
---
|
|
|
|
## Installation (Autohand-native project scope)
|
|
|
|
Commit the skill to a project so the whole team gets the same planning workflow:
|
|
|
|
```bash
|
|
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
|
|
mkdir -p .autohand/skills
|
|
cp -r /tmp/planning-with-files/skills/planning-with-files .autohand/skills/
|
|
git add .autohand/skills/planning-with-files
|
|
git commit -m "Add planning-with-files skill for Autohand Code"
|
|
rm -rf /tmp/planning-with-files
|
|
```
|
|
|
|
---
|
|
|
|
## Autohand Catalog Skills
|
|
|
|
Autohand Code can browse its community catalog with:
|
|
|
|
```bash
|
|
autohand --skill-install
|
|
```
|
|
|
|
Project-scoped catalog installs use:
|
|
|
|
```bash
|
|
autohand --skill-install <skill-name> --project
|
|
```
|
|
|
|
For this repository, use `npx skills add` or the direct clone paths above unless the skill appears in the Autohand catalog.
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
Start Autohand Code in your project. For complex tasks, the skill guides the agent to create and maintain:
|
|
|
|
- `task_plan.md` — phases, progress, and decisions
|
|
- `findings.md` — research and discoveries
|
|
- `progress.md` — session log and test results
|
|
|
|
The planning files live in your project root, not inside the skill directory.
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
- This is standard Agent Skills support. Claude Code plugin commands and Claude-specific hooks are not installed by this path.
|
|
- The underlying planning files are tool-agnostic and work across Claude Code, Cursor, Codex, Autohand Code, and other agents.
|
|
- If you use both shared `~/.agents/skills/` and Autohand-native directories, avoid installing duplicate copies of the same skill.
|