gustavo-santos-skills

skills

Central repository for my Agent Skills — playbooks that teach the agent how to execute specific tasks in my workflow.

Served via Skills Over MCP. Push to main and any connected MCP client picks up the change immediately.

MCP URL

https://mcp.skillsovermcp.com/mcp/gustavo-santos-swe/skills

Cursor: Settings → MCP → Add server → paste the URL above (transport: streamable-http).

Area structure

Skills organized under skills/<area>/<name>/. Skills Over MCP supports nested folders.

skills/
├── meta/           # discover, maintain, and sync skills
├── workflow/       # spec → plan → execution → PR
├── engineering/    # code, tests, review, MCP, tech debt
├── product/        # domain, discovery, positioning
├── design/         # UI/UX
├── mobile/         # React Native / Expo — native feel, performance
├── communication/  # prose and copy
├── marketing/      # pricing, launch, acquisition (reserved)
└── operations/     # support, metrics, deploy ops

Each SKILL.md includes metadata.area with the corresponding area.

Inventory

meta

Skill	Purpose
using-superpowers	Check available skills before acting
writing-skills	Create and maintain skills
writing-great-skills	Vocabulary/principles for predictable skills
handoff	Compact session for the next agent
teach	Multi-session teaching workspace
sync-upstream-skills	Check and sync skills with upstream repos
suggesting-skills	Suggest new skills

workflow

Skill	Purpose
brainstorming	Design and spec before implementing
grilling	Relentless interview until the decision tree is resolved
grill-me	User-invoked grilling entrypoint
batch-grill-me	Grilling in rounds (whole frontier at once)
writing-plans	Detailed implementation plan
executing-plans	Execute plan task by task
doc-coauthoring	Co-author specs, RFCs, PRDs
ship-feature	Commit, push, and open PR — never merge to main
git-conventions	Branch naming (feat/, fix/, chore/…) and conventional commit messages on every git action
quick-recap	Red/yellow/green status block convention at the end of every response

Source: obra/superpowers, mattpocock/skills, anthropics/skills, BuilderIO/skills — custom ship-feature. batch-grill-me from upstream in-progress.

engineering