Back to blog
Jul 20266 min read

Skills vs Prompts: The Simple Difference

Most people still talk to AI the same way they talk in chat: they explain everything every time. That works once. It fails when the work repeats.

Here is the simple difference.

A prompt is the request. A skill is the playbook the agent loads when that kind of request shows up again.

One example, two ways

You want a pull request reviewed.

1Way 1: Prompt only

You write a long request every time:

Review this PR. Check for bugs, security issues, missing tests, naming, and edge cases. Be strict. Give me blockers first, then nits. Suggest concrete fixes.

That can work. Tomorrow you write it again. Next week a teammate writes a weaker version. Next month nobody remembers the checklist. Quality drifts.

2Way 2: Skill + short prompt

You save a skill called PR Review once:

  • When to use: reviewing pull requests or code changes
  • Steps: read the diff, check security, check tests, check edge cases, check naming
  • Output: blockers first, then nits, then concrete fixes
  • Never: praise style while tests fail, or invent files that are not in the diff

Next time you only say:

Review PR 482. Focus on auth.

The short prompt is the request. The skill is the method. Same quality every time, without rewriting the checklist.

That is the whole idea.

Think of it like a kitchen

  • Order slip = prompt (what you want right now)
  • House rules = system prompt (always true: clean as you go, never invent facts)
  • Recipe card = skill (how we make this dish every time)
  • Tools and appliances = tools and APIs

You do not rewrite the pasta recipe every time a customer orders pasta. You write two carbonara on the ticket. The recipe already exists.

Three boxes, one rule

Put each instruction in one box only.

  • Prompt for this task only: Summarize this meeting for the client.
  • System prompt for who the agent always is: Be direct. Do not invent facts. Say when you are unsure.
  • Skill for work that repeats: Client meeting summary with structure, tone, what to include, what to leave out.
The rule

If you have typed the same instructions twice, it is not a prompt problem. It is a missing skill.

A second example: research

Prompt only looks like this:

Research this competitor. Cover pricing, features, ICP, strengths, weaknesses, and what we should do. Use recent sources. Keep it practical.

Useful once. Painful every Friday.

With a skill called Competitor Snapshot, you define the method once:

  • Trigger: competitor research, battlecard, win/loss prep
  • Always cover: who they sell to, pricing shape, top features, proof points, gaps, our angle
  • Format: one page, bullets, sources at the bottom
  • Check: every claim has a source or is marked as unknown

Your prompt becomes:

Run a competitor snapshot for Acme. Focus on mid-market EU.

Same structure every time. Faster ask. Cleaner output. Easier to improve the skill when you find a better format.

What goes where

  • Prompt: only for this one run. Example: Use the June numbers.
  • System prompt: should always be true. Example: Never invent customer quotes.
  • Skill: the method will be reused. Example: incident writeup, PR review, proposal draft.

If you dump all three into one giant prompt, the agent gets slower, less consistent, and harder to fix. Big prompts hide the real method. Skills make the method visible.

Why this compounds

A prompt helps today. A skill helps every future day that looks like today.

When a skill is wrong, you fix the skill once. Every future run gets better. That is compounding. Rewriting a long prompt in every chat is not compounding. It is renting the same answer again and again.

This pairs with loop engineering. The skill is the method. The loop is the engine that runs the method, checks the result, and keeps only what works. Method without a check is a hope. Check without a method is thrash.

Do this today

Pick one task you re-explained this month. Write a tiny skill on one page:

  • Name: plain words (PR Review, Client Update, Bug Triage)
  • When to use: 2-3 phrases a real person would say
  • Steps: the real checklist you already use
  • Never do: 2-3 past mistakes
  • Done means: the check that proves it worked

Then next time, send a short prompt and let the skill carry the method.

Example skill

Client Update. When: weekly client status or project update email. Steps: progress, risks, decisions needed, next week. Never: hide blockers in soft language. Done: a client can reply with yes or no on each decision. Prompt next Friday: Write the client update for Northwind.

The takeaway

  • Prompt = what you want right now
  • Skill = how we do this kind of work every time
  • System prompt = who we are while doing it

Keep prompts short. Keep identity stable. Put repeated judgment into skills.

We rebuild from the root method, then let it compound.

Related reading: How to Implement Loop Engineering in Your Project (/blog/loop-engineering).