An unofficial, interactive reading aid for pstack, poteto's set of engineering skills for coding agents.
A pair of static HTML pages (index.html and changelog.html) that explain pstack's playbooks, skills, and principles, with a live playbook router 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 whole app. 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.