Install Skills
Install the ACT Playbook skills with the GitHub CLI and configure the API keys some of them need.
Skills are installed with the GitHub CLI (gh). This works for Claude Code, Codex, and other supported agents.
Install the GitHub CLI
With Homebrew:
brew install ghWith WinGet, run in PowerShell:
winget install --id GitHub.cli --source wingetAfter installing, open a new terminal window so PATH changes take effect.
For other platforms and troubleshooting, see cli.github.com.
Sign in and install
Once gh is installed, sign in to GitHub:
gh auth login -h github.comThen install all ACT Playbook skills at user scope, so they are available across all your projects. When prompted, select the agents you use, for example Claude Code, Codex, or both:
gh skill install act-playbook/act-playbook-skills --all --scope userThis installs the following skills:
| Skill | Purpose |
|---|---|
/act-value-architecture-guide | Explain and apply the ACT Value Architecture |
/act-design-system-extractor | Extract a reusable project design system |
/act-voice-creator | Create or update a voice profile for a team member or brand account |
/act-competitive-intelligence | Research and analyse competitors using web search |
/act-website-builder | Complete B2B website workflow |
/act-website-audit | Audit an existing B2B website |
/act-website-plan | Plan the target site structure |
/act-website-seo | Generate keyword research and page SEO briefs |
/act-website-generate | Generate HTML pages from an approved structure |
Set Up API Keys
Some skills require API keys. Keys go in a file called .env.local in your repository. This file is excluded from Git, so your keys are never committed.
Copy the included .env file to create your .env.local:
cp .env .env.localThen open .env.local and fill in any keys you need. Check the ACT Playbook Skills README for which skills require external accounts and where to get the keys.
Reload After Installing
After installing, reload your agent so the new skills are available.
Claude Code in VS Code: open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows, or via View → Command Palette) and run Developer: Reload Window.
Keep Skills Up to Date
To update your skills, run:
gh skill update --allAfter updating, reload your agent the same way as after the initial install.