---
slug: "claude-skills-automation"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/Toowiredd/claude-skills-automation@master/README.md"
repo: "https://github.com/Toowiredd/claude-skills-automation"
source_file: "README.md"
branch: "master"
---
# Claude Skills Automation

> **Fully automated memory and context management for Claude Code**
>
> Zero-friction development with automatic context restoration, decision tracking, and permanent memory.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude-Code-blue.svg)](https://claude.ai/code)
[![Status](https://img.shields.io/badge/Status-Production%20Ready-green.svg)]()

---

## 🎯 What This Does

Eliminates **all manual memory management** in Claude Code through automated hooks:

### Before ❌
```
You: [Start Claude Code]
Claude: "How can I help?"
You: "hi-ai, what were we working on?"
You: "Remember we're using PostgreSQL"
You: "What did we decide about React?"
```

### After ✅
```
You: [Start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Using PostgreSQL for database (2 days ago)
• Chose React + Vite for frontend (3 days ago)
• Implementing JWT authentication (5 days ago)

**Memory system active**. Ready to continue!

You: [Just start working - context already there]
```

**Zero manual "hi-ai". Zero manual "remember". Just works.**

---

## ✨ Features

### 🚀 Automatic Context Restoration
- Session starts → Context automatically injected
- No more "hi-ai" commands
- Instant continuation from where you left off

### 💾 Automatic Decision Extraction
- Detects decisions from conversation patterns
- Extracts: "using", "chose", "decided", "implemented"
- Saves to memory automatically

### 🚧 Automatic Blocker Tracking
- Detects obstacles: "can't", "blocked by", "waiting for"
- Tracks active blockers
- Surfaces them in next session

### 📝 Automatic Session Saving
- Saves state on session end
- Backs up full transcript
- Never lose context

### 🔍 File Change Tracking
- Monitors significant file edits
- Logs DECISIONS.md, README, code changes
- Creates audit trail

### 💪 Neurodivergent-Optimized
- **ADHD**: Zero friction, immediate execution
- **SDAM**: Complete external memory system
- **Aphantasia**: Visual outputs, concrete examples
- **Dyschronometria**: Time-anchored context
- **Anendophasia**: Externalized reasoning

---

## 🚀 Quick Start

### Basic Installation (2 minutes)

```bash
# Clone repository
git clone https://github.com/toowiredd/claude-skills-automation
cd claude-skills-automation

# Run basic installer
bash scripts/install.sh
```

### Supercharged Installation with Paid Subscriptions Integration

If you have Pieces.app, GitHub Copilot Pro, Docker Pro, Codegen-ai, Jules CLI, or Codacy:

```bash
# Run enhanced installer
bash scripts/install-integrations.sh

# See full integration guide
cat docs/SUBSCRIPTIONS_INTEGRATION.md
```

That's it! Your next Claude Code session will have full automation.

### Verification

```bash
# Start Claude Code session
# Context should appear automatically

# Check automation logs
tail -f ~/.claude-memories/automation.log
```

---

## 📋 What Gets Installed

### Automation Hooks

**Core Hooks (5)** - Memory & context automation:
| Hook | Size | Executes When | Performance |
|------|------|---------------|-------------|
| `session-start.sh` | 3.1 KB | Session starts | 100ms |
| `session-end.sh` | 2.0 KB | Session ends | 50ms |
| `stop-extract-memories.sh` | 2.6 KB | After each response | 200ms |
| `post-tool-track.sh` | 1.4 KB | After file edits | 10ms |
| `pre-compact-backup.sh` | 1.5 KB | Before compression | 100ms |

**Integration Hooks (7)** - 🆕 Paid subscriptions:
- `async-task-jules.sh` - Jules CLI async tasks
- `error-lookup-copilot.sh` - GitHub Copilot error search
- `pre-commit-copilot-review.sh` - AI code review
- `pre-commit-codacy-check.sh` - Quality gates
- `post-tool-save-to-pieces.sh` - Pieces.app sync
- `testing-docker-isolation.sh` - Docker isolated tests
- `codegen-agent-trigger.sh` - Autonomous agents

**Total overhead per session**: <500ms (core only)

### 8 Claude Skills

**Core Skills (5)**:
- **session-launcher** - Zero context loss restoration
- **context-manager** - Permanent memory management
- **error-debugger** - Smart debugging with past solutions
- **testing-builder** - Automatic test generation
- **rapid-prototyper** - Fast idea validation

**New Skills (3)** 🆕:
- **browser-app-creator** - Generates single-file HTML/CSS/JS apps (ADHD-optimized, 60px+ buttons, localStorage)
- **repository-analyzer** - Analyzes codebases, generates documentation, detects patterns, extracts TODOs
- **api-integration-builder** - Creates TypeScript API clients with retry logic, rate limiting, and auth

### Memory Storage
```
~/.claude-memories/
├── index.json              # Master memory index
├── decisions/              # Architecture decisions
├── blockers/               # Active obstacles
├── procedures/             # How-to guides
├── backups/                # Session backups
├── automation.log          # Hook execution log
└── auto-extracted.log      # Auto-extracted memories
```

---

## 📖 Documentation

- **[Quick Start](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/QUICK_START.md)** - Get started in 5 minutes
- **[Complete Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md)** - Full documentation (3,500+ lines)
- **[Subscriptions Integration](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/SUBSCRIPTIONS_INTEGRATION.md)** - 🆕 Paid subscriptions integration guide
- **[Implementation](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/AUTOMATION_IMPLEMENTATION.md)** - Technical details
- **[Research](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/AUTOMATION_RESEARCH.md)** - How we built this

---

## 🎓 How It Works

### System Architecture

```
┌─────────────────────────────────────────┐
│   SessionStart Hook (100ms)              │
│   • Load memory index                    │
│   • Extract recent decisions             │
│   • Find active blockers                 │
│   • Inject context into conversation     │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   You Work Normally                      │
│   • Code, debug, design                  │
│   • Skills activate as needed            │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   PostToolUse Hook (10ms)                │
│   • Track file modifications             │
│   • Log significant changes              │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Stop Hook (200ms)                      │
│   • Analyze conversation                 │
│   • Extract decision patterns            │
│   • Extract blocker patterns             │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   SessionEnd Hook (50ms)                 │
│   • Save session state                   │
│   • Backup transcript                    │
└─────────────────────────────────────────┘
```

### Decision Extraction Patterns

Automatically detects and extracts:

| Pattern | Example | Extracted As |
|---------|---------|--------------|
| "using X" | "We're using PostgreSQL" | DECISION |
| "chose X" | "Chose React over Vue" | DECISION |
| "decided X" | "Decided to implement caching" | DECISION |
| "can't X" | "Can't access the API" | BLOCKER |
| "blocked by X" | "Blocked by missing keys" | BLOCKER |

---

## 🧪 Example Session

### First Session
```bash
You: "Let's build a task tracker with React and PostgreSQL"
Claude: "Great! Let's start..."

# Behind the scenes:
# → Stop hook extracts: "build a task tracker with React and PostgreSQL"
# → Logs as DECISION
# → SessionEnd saves state
```

### Next Session
```bash
[You start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Build a task tracker with React and PostgreSQL (1 day ago)

**Last Working On:** Building task tracker

Ready to continue!

# Zero manual effort - context just there
```

---

## 🔧 Requirements

- **Claude Code** (latest version)
- **Bash** (pre-installed on Linux/macOS)
- **jq** (for JSON processing)
  ```bash
  # Install jq if needed
  sudo apt install jq  # Ubuntu/Debian
  brew install jq      # macOS
  ```

---

## 📊 Performance

| Metric | Value |
|--------|-------|
| Installation time | 2 minutes |
| Hook overhead/session | <500ms |
| Disk usage/year | <100MB |
| Maintenance required | Zero |

---

## 🌟 Community & Credits

Built on research from:
- [claude-code-hooks-mastery](https://github.com/disler/claude-code-hooks-mastery)
- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code)
- [Claude-Code-Everything-You-Need-to-Know](https://github.com/wesammustafa/Claude-Code-Everything-You-Need-to-Know)

### Why We Built This

Designed specifically for **neurodivergent developers**:
- ADHD → Zero friction, immediate results
- SDAM → Complete external memory
- Dyschronometria → Time-anchored context
- Aphantasia → Visual, concrete outputs

---

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/CONTRIBUTING.md) for guidelines.

### Ideas for Contributions

- 🎯 New extraction patterns
- 🔧 Additional hooks
- 📚 More skills
- 🌍 Translations
- 🎨 Better documentation
- 🧪 Tests

---

## 📝 Advanced Usage

### Custom Decision Patterns

Edit `~/.config/claude-code/hooks/stop-extract-memories.sh`:

```bash
# Add your own patterns
local decision_patterns="using|chose|decided|MY_PATTERN"
```

### Pieces.app Integration

Three integration options:
1. Auto-save code to Pieces
2. Export memories to Pieces
3. Use Pieces API as backend

See [Pieces Integration Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md#piecesapp-integration)

### Project-Specific Hooks

Create `.claude/hooks/` in your project for custom automation.

---

## 🐛 Troubleshooting

### Hooks Not Firing?

```bash
# Check hooks are executable
ls -l ~/.config/claude-code/hooks/*.sh

# Fix permissions
chmod +x ~/.config/claude-code/hooks/*.sh
```

### Context Not Appearing?

```bash
# Verify memory index
cat ~/.claude-memories/index.json
jq '.total_memories' ~/.claude-memories/index.json
```

More help: [Troubleshooting Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md#troubleshooting)

---

## 📜 License

MIT License - see [LICENSE](https://github.com/Toowiredd/claude-skills-automation/tree/HEAD/LICENSE)

---

## 🙏 Acknowledgments

Built for the neurodivergent developer community.

If this helps you:
- ⭐ Star this repo
- 🐛 Report issues
- 💡 Suggest improvements
- 🤝 Contribute code

---

## 📞 Support

- **Issues**: [GitHub Issues](https://github.com/toowiredd/claude-skills-automation/issues)
- **Discussions**: [GitHub Discussions](https://github.com/toowiredd/claude-skills-automation/discussions)
- **Docs**: [Complete Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md)

---

## 🎯 Problem → Solution

### For ADHD Developers
| Before ❌ | After ✅ |
|----------|---------|
| Context lost between sessions | Context auto-restored |
| Forget to track decisions | Decisions auto-extracted |
| Manual memory = friction | Zero manual work |

### For SDAM (No Episodic Memory)
| Before ❌ | After ✅ |
|----------|---------|
| Can't remember past decisions | Perfect external memory |
| "What did we decide?" unanswerable | All decisions saved |
| Repeat same mistakes | Past solutions auto-recalled |

### For All Developers
| Before ❌ | After ✅ |
|----------|---------|
| Context loss = productivity drain | Zero context loss |
| Manual "hi-ai" every session | Automatic restoration |
| No session continuity | Seamless continuation |

---

## 🚀 Status

✅ **Production Ready** - Fully tested
✅ **Actively Maintained** - Regular updates
✅ **Community Driven** - Contributions welcome

---

## 📈 Quick Stats

- **12** automation hooks (5 core + 7 integrations)
- **8** Claude Skills (5 core + 3 new)
- **<500ms** overhead
- **<100MB** disk usage/year
- **Zero** maintenance required
- **100%** neurodivergent-optimized

---

**Zero friction. Zero context loss. Forever.**

*Built with ❤️ for the neurodivergent developer community*

---

## Star History

If this project helps you, please consider starring it! ⭐