agent-skills

Reusable Claude Code and Amp skills from @lelouvincx.

Skills

Skill	Type	Description
slackcli	Local	Interact with Slack workspaces via the slackcli CLI
bigquery-query	Local	Query Google BigQuery datasets using the bq CLI
notion	Remote	Manage Notion pages, databases, and comments
modern-web-guidance	Remote	Search tool for modern web development best practices
linear-cli	Remote	Manage Linear issues from the command line
shadcn	Remote	Manage shadcn/ui components — adding, styling, composing UI
playwright-skill	Remote	Browser automation for web projects using playwright-cli
remotion	Remote	Best practices for Remotion - Video creation in React
copywriting	Remote	Expert conversion copywriting for marketing pages
ponytail	Remote	Lazy senior dev mode — forces simplest/minimal solution (YAGNI, stdlib first)
ponytail-review	Remote	Code review hunting only over-engineering — what to delete
ponytail-help	Remote	Quick-reference card for ponytail modes and commands
writing-great-skills	Remote	Reference for writing and editing skills well
govuk-style	Remote	GOV.UK-style plain-English writing, adapted for presales and customer Slack messages

Setup

git clone <repo-url>
cd agent-skills
./sync-skills.sh --remote   # fetch remote skills
./sync-skills.sh             # local

sync-skills.sh also syncs version-controlled Amp runtime artifacts from this repo into ~/.config/amp:

amp/AGENTS.md          -> ~/.config/amp/AGENTS.md
amp/plugins/           -> ~/.config/amp/plugins/
amp/docs/tools/        -> ~/.config/amp/docs/tools/

Use AMP_CONFIG_DIR=/path/to/amp-config ./sync-skills.sh to test against a temporary Amp config directory.

Amp artifacts

Amp plugins and plugin capability docs are maintained under amp/ in this repo. Treat ~/.config/amp as the runtime projection, not the long-term source of truth.

When changing a plugin capability:

1. Update amp/docs/tools/*.md first.
2. Update amp/plugins/*.ts to match the documented contract.
3. Run ./sync-skills.sh to project the change into ~/.config/amp.

Adding Skills

Local: Create skills/my-skill/SKILL.md with YAML frontmatter, then run ./sync-skills.sh.

Remote: Add to remote-skills.yaml:

skills:
  - name: my-remote-skill
    url: https://raw.githubusercontent.com/user/repo/main/skills/my-skill/SKILL.md
    enabled: true
    files: # optional companion files
      - references/commands.md

• Add .gitignore entries for the generated files (SKILL.md, .remote-source, and any companion file directories):

  skills/my-remote-skill/SKILL.md
  skills/my-remote-skill/.remote-source
  skills/my-remote-skill/references/

• Optionally add personal context in skills/my-remote-skill/PERSONAL.md.
• It gets prepended to the fetched SKILL.md.
• Run ./sync-skills.sh --remote to sync.

Removing Skills

Local: Delete skills/my-skill/, remove its row from the skills table above.

Remote: Remove the entry from remote-skills.yaml and delete the skill directory:

rm -rf skills/my-remote-skill
./sync-skills.sh --remote   # cleans up stale entries

If the skill was gitignored (check .gitignore), remove those lines too. Remove its row from the skills table above.