An unofficial, interactive reading aid for pstack, poteto's set of engineering skills for coding agents. Not affiliated with poteto, pstack, or Cursor.
Static HTML pages that explain what pstack is, how to start, and when each playbook and skill applies. Includes a live playbook router, grouped catalogs with copyable prompts, and a standalone upstream changelog. No build step, no dependencies.
https://hustlecoding.github.io/pstack-explained/
GitHub Pages, served by a GitHub Actions workflow in .github/workflows/deploy.yml. Every push to master publishes the repository root as the Pages site. The Pages source is set to GitHub Actions (not a branch), so the workflow owns the deployment.
Open index.html or changelog.html in any browser, or run python3 -m http.server 8000 from the repo root.
index.html is the main app: a copyable "what do I type?" board, a which-one chooser, drift corrections, a page finder, the routing demo, and the playbook, skill, and principle catalogs. Markup, styles, data, and router logic live inline.
.github/workflows/deploy.yml is the GitHub Pages deployment workflow.
changelog.json is the upstream pstack digest, generated by .github/scripts/sync-pstack.py.
changelog.html is the standalone, pre-rendered changelog page.
agent-templates.html is a standalone page explaining the lionbenjamin/agent-templates toolkit.
changelog.md is a plain Markdown version of the changelog for AI agents.
llms.txt and llms-full.txt provide LLM-readable context about the whole site.
.github/workflows/sync-pstack.yml runs weekly and fetches any new commits from cursor/plugins/pstack. If it finds changes, it commits an updated changelog.json, then runs .github/scripts/generate.py to regenerate changelog.html, changelog.md, and llms-full.txt before redeploying the site.
og.png and the favicon.* / apple-touch-icon.png files are the social preview and icon assets.
The workflow in .github/workflows/sync-pstack.yml runs every Monday at 09:00 UTC. It polls the pstack directory in cursor/plugins, appends new commits to changelog.json, and deploys the updated site (including changelog.html). Run it manually from the Actions tab at any time.
This page mirrors the pstack skills installed on the author's machine, not a live install. pstack itself ships as a plugin via /add-plugin pstack; this repository is an independent explanatory tool, not affiliated with pstack.