npm package: @pewterzz/pstack
Description: Personal reference cookbook for small local LLMs — 29 AgentSkills for Zed and OpenClaw
Latest version: 1.0.2

# pstack

A personal opinionated reference cookbook for small local LLMs.

## What is this?

pstack is an organized collection of recipes, commands, patterns, and cheat sheets you can point a small, forgetful LLM at when it doesn't know how to do something.

Target model: **gemma-4-e2b-it-q5_k_m** — capable but easily forgets command flags, language syntax, and patterns that larger models recall instantly.

Works with **Zed** (via `@file` / `/file` in the Agent Panel) and **OpenClaw** (via `/skill` commands).

## How to use

### With Zed
In the Agent Panel, reference any file directly:
```
@file .agents/skills/shell/SKILL.md
@file .agents/skills/python/async.md
```
Or use `/file` in Text Threads:
```
/file .agents/skills/git/recovery.md
```
The `.rules` file at the root is auto-loaded by Zed as project rules.

### With OpenClaw
Skills in `.agents/skills/` follow the AgentSkills standard and are auto-discovered.
Invoke any skill by name:
```
/shell
/git
/python
```
Or point the model at a specific recipe file:
```
/file .agents/skills/docker/compose.md
```

## Skill Categories

| Skill | What it covers |
|-------|----------------|
| `shell` | Bash/Zsh scripting, builtins, pipelines, one-liners |
| `shell-config` | Zsh config, Fish config, dotfiles, prompt setup |
| `cli-tools` | curl, jq, sed, awk, xargs, find |
| `git` | Rebase, cherry-pick, bisect, reflog, recovery |
| `gh-cli` | GitHub CLI (gh), PRs, issues, Actions, releases |
| `web-research` | Deep research patterns, search operators, APIs for research |
| `python` | stdlib, asyncio, packaging (uv/pip), decorators, dataclasses |
| `javascript` | ES2020+, Node.js APIs, npm |
| `typescript` | Types, generics, utility types, tsconfig |
| `react` | Hooks, patterns, Next.js, App Router |
| `supabase` | Auth, database, Edge Functions, Realtime, RLS |
| `go` | stdlib, error handling, goroutines, modules |
| `rust` | Ownership, traits, Result/Option, cargo |
| `swift` | SwiftUI, patterns, Xcode, SPM |
| `cpp` | Modern C++20, STL, memory, CMake |
| `gpu` | CUDA, Metal, kernel patterns |
| `docker` | Dockerfile, compose, container commands |
| `sql` | JOINs, CTEs, window functions, Postgres-specific |
| `regex` | Common patterns across languages |
| `api-patterns` | REST conventions, GraphQL, JWT, OAuth2 |
| `testing` | pytest, jest, test patterns |
| `containers` | Kubernetes kubectl, cloud CLIs (aws/gcloud/az) |
| `networking` | ssh, rsync, netcat, dig, tcpdump |
| `files-and-data` | JSON, YAML, TOML, CSV processing |
| `datetime` | Parsing, formatting, timezones, arithmetic |
| `error-handling` | Try/catch, Result types, retry, circuit breaker |
| `security` | Hashing, encryption, secrets, input validation |

## Design principles

1. **Self-contained recipes** — every example is complete and runnable
2. **No ambiguity** — real values, all flags shown, no `...` truncation
3. **Small-model friendly** — explicit, redundant, copy-pasteable
4. **Topic-organized** — find by subject, not workflow stage
5. **Pure markdown** — no build system, no dependencies
6. **Context-window aware** — each file kept under 200 lines

## Adding a new category

1. Create `.agents/skills/<topic>/SKILL.md` with this frontmatter:
   ```yaml
   ---
   name: <topic>
   description: <one line>. Use when <trigger>.
   ---
   ```
2. Add recipe files as `<topic>/<name>.md`
3. Update this README

## License

MIT