Claude-skill-registry alto-self-fix

Use when ALTO needs to fix itself via GitHub issues. Procedural workflow for running /alto-self-fix or solving issues through ALTO's self-improvement process.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/alto-self-fix" ~/.claude/skills/majiayu000-claude-skill-registry-alto-self-fix && rm -rf "$T"

manifest: skills/data/alto-self-fix/SKILL.md

ALTO Self-Fix Procedure

Procedural workflow for ALTO to fix itself via GitHub issues.

Workflow

1. Get Issue

gh issue view <number> --repo gonzaloetjo/alto

Read and understand the issue requirements.

2. Create Branch

git checkout -b issue-<number>-<short-description>

3. Implement

Modify ALTO source files as needed:

```
devenv.nix
```
- Options, scripts, hooks config
```
agents/*.md
```
- Agent prompts
```
hooks/*.py
```
- Hook logic
```
skills/*/SKILL.md
```
- Skills
```
templates/CLAUDE.md.*
```
- Protocols

4. Validate

nix-instantiate --parse devenv.nix > /dev/null && echo "Nix OK"
python3 -m py_compile hooks/*.py && echo "Python OK"

5. Test (if behavior change)

alto-test-run --scenario <relevant> --keep --json

Skip for string/doc-only changes.

6. Update CHANGELOG

Add entry under

## [Unreleased]

with issue reference.

7. Commit

git add <files>
git commit -m "feat: description (#<issue>)"

8. Push & PR

git push -u origin issue-<number>-<description>
gh pr create --title "feat: description (#<number>)" --body "Closes #<number>"

Notes

Never commit to main directly
```
changelog-check
```
hook enforces CHANGELOG updates
```
alto-restart
```
is blocked in dev mode
Changes apply next session