Developer using AI coding agentsRising demand

AI coding agent brief

Immediate result: A precise brief for an AI coding agent: goal, files, constraints, acceptance tests and what not to touch.

Problem it solvesVague prompts to coding agents (Cursor, Claude Code, Copilot) produce code that misses the point.

Download SKILL.md
Add this skill to
ChatGPTClaudeGeminiPerplexity

You paste

Add dark mode to our React app; don't touch the charts library

You get

Goal: user-selectable dark theme, saved per user, default follows the OS.

Out of scope: src/charts/** (do not edit).

Done when: toggling theme updates all pages; contrast ≥ 4.5:1; existing tests pass.

About this skill

About AI coding agent brief

Coding agents such as Cursor, Claude Code and Copilot are only as good as the brief they get. This skill turns a loose request into a precise one: the goal, a definition of done, the files in scope and the ones that are off-limits, acceptance tests the agent must make pass, constraints on style and dependencies, and the points where it should stop and ask. Briefs written this way produce smaller, reviewable changes and fewer surprise rewrites. It is the core habit of working with agents — and works for briefing human developers too.

AI coding agent brief AI skill for Developer using AI coding agents: you paste "Add dark mode to our React app; don't touch the charts library" and get "Goal: user-selectable dark theme, saved per user, default follows the OS."
AI coding agent brief — example input and the first lines it returns. Works in ChatGPT, Claude and Gemini.
Job profile
Software engineering · Developer using AI coding agents
Works in
ChatGPT, Claude, Gemini, Copilot, Claude Code
Format
Agent Skills (SKILL.md)
Price
Free, no sign-up
Install instructions

Copy, paste, send

  1. Cold email writerCopy skillCopied ✓1 Copy the skillPress Copy skill.
  2. ANY AI ASSISTANTSKILLPaste here, then press Enter2 Paste it into a new chatChatGPT, Claude, Gemini or Copilot.
  3. ANY AI ASSISTANT3 Send your inputSend what you want built or changed.
The skill — paste this into your AI assistant
# Skill: AI coding agent brief

You are running the "AI coding agent brief" skill for me. I work as: Developer using AI coding agents. What I need from you: a precise brief for an AI coding agent: goal, files, constraints, acceptance tests and what not to touch.

## When I send you what I want built or changed, my stack and anything that must not change
1. Turn the request into a goal and a definition of done.
2. List the files or areas likely involved and the ones that are off-limits.
3. Write acceptance tests the agent must make pass.
4. Add constraints: style, dependencies allowed, no new packages unless approved.

## Reply in this format
- Goal
- Definition of done
- Scope (in / out)
- Acceptance tests
- Constraints
- Ask before

## Rules
- Use only the facts I give you; mark anything you had to assume with [ASSUMPTION].
- If something essential is missing, ask me one short question, then continue.
- No preamble or filler: start with the result.

Confirm you're ready in one line, then wait for me to send what I want built or changed, my stack and anything that must not change.

Then sendWhat you want built or changed, your stack and anything that must not change. For example: Add dark mode to our React app; don't touch the charts library

ChatGPT

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: open a Project, choose Instructions (or Settings → Personalization → Custom instructions for every chat) and paste it there.
  3. To share it with a team: create a custom GPT and paste the skill into its Instructions.
  4. In the Codex app: copy the skill's folder into ~/.codex/skills/ (or Customize → Skills → Add → Create skill).

Claude

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: create a Project, open Project instructions and paste the skill.
  3. As a Claude Skill: download the skill's ZIP, then in Claude open Settings → Skills → Add → Upload skill and choose the file.

Gemini

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: open Gems → New Gem, paste the skill into Instructions and save.

Microsoft Copilot

  1. Fastest: paste the skill as your first message, then send your input.
  2. In Microsoft 365 Copilot, save it as a prompt or paste it into an agent's instructions to reuse it.

Any other assistant

  1. Paste the skill as the system prompt or first message in any chat assistant (Perplexity, Meta AI, DeepSeek, Mistral, local models).
  2. Coding agents that read the Agent Skills format (SKILL.md) can load the downloaded file from their skills folder.

Install it permanently

Upload it to Claude, add it to ChatGPT's Codex app, clone it into Claude Code, or download the SKILL.md for any agent. Full guide with screenshots →

Download the ZIP and upload it in Claude. Claude then uses the skill on its own whenever a request matches.

Download ZIP

Quick setup

  1. In Claude, open Settings → Skills (under Customize).
  2. Click Add → Upload skill.
  3. Choose the ZIP — don't unzip it — and make sure the skill is switched on.
Claude Settings with Skills selected under Customize, and the Add menu open showing Upload skill, Create a skill, Create with Claude and Record your screen

Repositoryscienceofapps.com/skills/ai-skills.git · all 200 skills, one folder each, plain git over HTTPS

What it does

The steps it follows

  1. Turn the request into a goal and a definition of done.
  2. List the files or areas likely involved and the ones that are off-limits.
  3. Write acceptance tests the agent must make pass.
  4. Add constraints: style, dependencies allowed, no new packages unless approved.
What you get back

The reply format

  • Goal
  • Definition of done
  • Scope (in / out)
  • Acceptance tests
  • Constraints
  • Ask before
FAQs

Questions about AI coding agent brief

What does the AI coding agent brief skill do?

Vague prompts to coding agents (Cursor, Claude Code, Copilot) produce code that misses the point. The skill fixes that: a precise brief for an AI coding agent: goal, files, constraints, acceptance tests and what not to touch.

How do I install AI coding agent brief in ChatGPT, Claude or Gemini?

Copy the skill and paste it as the first message of a new chat, then send your input. To keep it, paste it into a ChatGPT Project or custom GPT, a Claude Project or a Gemini Gem, or upload the SKILL.md file as a Claude Skill.

What do I send AI coding agent brief after installing it?

Send what you want built or changed, your stack and anything that must not change. If something essential is missing, the skill asks you one short question and then continues.

Is the AI coding agent brief skill free?

Yes. It's free to copy, use and adapt, with no sign-up, and works in the free versions of ChatGPT, Claude, Gemini and Copilot.

More for software engineering
Software engineer

Dependency upgrade planner

ProblemMajor version upgrades break builds in ways the changelog doesn't make obvious.

You paste

React Router 6 → 7, package.json attached

You get

Affects you: json() and defer() are deprecated — return plain objects from loaders.

Step 1: upgrade to the latest 6.x and turn on the future flags; fix warnings.

Then: npm i react-router@7 and remove react-router-dom.

Immediate resultAn ordered upgrade plan with breaking changes that affect your code and a test checklist.

How to use it
Developer / open-source maintainer

README writer

ProblemProjects without a clear README don't get used, contributed to or understood by the next hire.

You paste

CLI in Go that resizes images in bulk; main.go, go.mod, flags: -w -h -q

You get

# imgshrink — resize thousands of images in one command

## Quick start: go install …/imgshrink@latest && imgshrink -w 1200 ./photos

| Flag | Default | Meaning | -q | 82 | JPEG quality |

Immediate resultA README with what it does, quick start, configuration, examples and contribution notes.

How to use it
Software engineer

Stack trace debugger

ProblemA stack trace points at a line, not at the cause, and searching the error message wastes an hour.

You paste

TypeError: Cannot read properties of undefined (reading 'map') at OrderList.tsx:14

You get

Root cause: orders is undefined on first render — the fetch hasn't resolved.

Fix: const orders = data?.orders ?? []

Confirm: reload with network throttled to Slow 3G; the list renders empty, then fills.

Immediate resultThe most likely root cause, the exact line to change and a command to confirm the fix.

How to use it

All 20 software engineering skillsAll 200 skillsRead it in the articleProve it: AI for Software Developers Certification (free test)

Free PDF · 74 pages · 2 editions

The Laws of UX, in one field guide

60 research-backed principles in 6 categories — what each one means, why it works on the human brain and how to use it on your own screens. Written by Sushant Singh, founder of Science of Apps, who has scaled consumer apps to lacs of users and spent 10+ years leading product across startups and digital businesses in the US, EU & India.

Pick your edition
Free. No card, no paywall — just your email.
Free PDF · 74 pages

Get Laws of UX by email

Choose your edition

You’ll also get occasional UX psychology tips. Unsubscribe anytime. Privacy policy

Free PDF · 90 pages · 2 editions

100+ Subscription Paywalls, decoded

110 real paywalls from top apps, taken apart, rated out of 5 and decoded with the Laws of UX — plus the frameworks, copy and checklists to ship your own. By Sushant Singh, founder of Science of Apps.

  • 110 paywalls rated
  • 34 Laws of UX
  • 12 frameworks

Which paywall scored 4.8 out of 5, and which scored 2.6? It’s all inside.

Pick your edition
Free. No card, no paywall — just your email.
Free PDF · 90 pages

Get 100+ Paywalls, Decoded by email

Choose your edition

You’ll also get occasional UX psychology tips. Unsubscribe anytime. Privacy policy