Agent Resources

Battle-tested agent skills and Cursor rules from real projects. Works with Cursor, Claude Code, and any agent.

What's Inside

• Skills -- Repeatable workflows your agent can follow (SKILL.md files)
• Rules -- Persistent context for Cursor sessions (.mdc files)

Quickstart

Install all skills

Platform	Command
Cursor / npx	npx skills@latest add jcottam/agent-resources
Claude Code	/plugin marketplace add jcottam/agent-resources then /plugin install agent-resources

Install a single skill

Platform	Command
Cursor / npx	npx skills@latest add jcottam/agent-resources/skills/engineering/ship
Manual (any agent)	Copy SKILL.md into ~/.cursor/skills/<skill-name>/

Update installed skills

npx skills update

Skills

Design

Skill	Description
content-wireframe	Draft a content wireframe for a website or page before any design or code. Produces a structured markdown document with real copy, section intent, and open decisions.

Engineering

Skill	Description
orient	Orient a developer to an unfamiliar codebase by systematically exploring its structure, purpose, features, conventions, and workflows.
ship	Validate a branch, run quality gates, update documentation and changelog, and open a pull request.
review-pr	Forensic, timeline-first PR review that reconstructs commit narrative before forming opinions, with rigorous evaluation and confidence-tagged findings.
squash-branch	Group related commits into a clean history while proving the final code is unchanged.
promote-skill	Move a tested personal skill into a shared repository with overlap checks, normalized metadata, catalog updates, and validation.

Publishing

Skill	Description
host	Upload files to Cloudflare R2 and return a shareable public URL with slug naming, clipboard copy, and hosting history.

Productivity

Skill	Description
release-notes	Summarize a chosen grouping of commits (this branch, a PR, or recent commits) into plain-language release notes for non-technical readers at a chosen reading level.
handoff	Compact session context into ~/.agents/handoffs/ with deduped artifact references, next-session focus, and suggested skills for resume.

Thinking

Skill	Description
advisor	Rigorous, no-nonsense advisory mode. Eliminates sycophancy, enforces intellectual honesty, and produces thorough analysis with explicit confidence levels.
sounding-board	Opinionated rubber duck that reflects your thinking back, flags gaps, and offers suggestions one exchange at a time.

---

Rules

Cursor rules (.mdc files) will be added to the rules/ directory over time. See the rules README for format and installation instructions.

Resources

Other skills and tools worth checking out.

Resource	Description
skills.sh	Registry and CLI for discovering, installing, and managing agent skills.
mattpocock/skills	Engineering and productivity skills for real development -- TDD, diagnosis, and more.
Grill Me	Matt Pocock's interviewing skill that stress-tests a plan or design until every decision branch is resolved.
Wayfinder	Matt Pocock's skill for charting work too big for one session as a shared map of decision tickets until the path is clear.
I Have ADHD	ayghri's skill that shapes agent output for ADHD readers -- action first, numbered steps, no buried answers.
Brainstorming	Jesse Vincent's skill that turns a rough idea into an approved design through questions, alternatives, and a hard gate before any implementation.
forrestchang/andrej-karpathy-skills	Behavioral guidelines derived from Karpathy's observations on LLM coding pitfalls.
garrytan/gstack	23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, and QA.
pbakaus/impeccable	Design language that makes your AI better at design.
squirrelscan/squirrelscan	Website auditing tool built for agent and LLM workflows.
JimLiu/baoyu-skills	Content creation skills -- infographics, image cards, markdown formatting, and HTML conversion.
Introduction to Agent Skills	Anthropic's course on writing and using agent skills.

Contributing

Add a skill

1. Create skills/<category>/<skill-name>/SKILL.md with YAML frontmatter:

---
name: my-skill
description: One-liner explaining when to use this skill.
---

# My Skill

Skill instructions here...

2. Add the skill path to .claude-plugin/plugin.json in the skills array.
3. Add a row to the skills table in this README.

Ad