Skip to content

Skills & Workflows

Throughout this course, you have learned how to give AI agents instructions through prompts and configuration files. Skills and workflows take this one step further. They are standardized, repeatable sets of instructions that produce consistent results every time they run.

Think of a skill like a recipe. When you follow a recipe, you get the same dish every time: the same ingredients, the same steps, the same result. Without a recipe, you are improvising. Sometimes the result is great, sometimes it is not, and it is hard to repeat a success.

Skills work the same way for AI agents. Instead of giving the AI a vague instruction like “write me a blog post,” a skill provides a complete, structured set of instructions: what to write, how to format it, what sections to include, what tone to use, and what to check before finishing. The result is predictable and consistent.

A workflow is simply a skill that involves multiple steps in sequence. For example, a blog writing workflow might include: research the topic, create an outline, write the draft, add a call to action, and format for publishing. Each step feeds into the next, and the entire process runs the same way every time.

Skills solve three fundamental problems with AI agents:

Without a skill, the same prompt can produce wildly different outputs depending on the day, the model version, or even random variation in the AI’s response. One day you get a 200-word summary, the next you get a 500-word essay. Skills eliminate this randomness by specifying exact requirements.

When you invest time writing a detailed skill with clear instructions, quality checks, and formatting rules, you get better output than you would from an improvised prompt. The skill encodes your best thinking about how the task should be done.

Once you write a skill that works well, you can share it with colleagues, friends, or classmates. They can use the same skill with their own AI agent and get similar results. This makes skills a form of reusable knowledge that can be distributed across teams and communities.

A skill file is a structured document (usually a Markdown file) that defines everything the AI needs to do the task. While the exact format varies by platform, most skills contain these core elements:

A clear, descriptive name for the skill.

A one-or-two sentence explanation of what the skill does. This helps you (and others) quickly understand the skill’s purpose.

The detailed, step-by-step instructions the AI should follow. This is the heart of the skill. It includes:

  • What the AI should do at each step
  • What format the output should use
  • What rules and constraints apply
  • What to check before marking the task complete

A sample input and the expected output. This gives the AI a concrete reference for what “correct” looks like.

Here is what a complete skill file looks like:

# Skill: Weekly Report Summary
## Description
Summarize a weekly status report into a concise executive brief
for senior leadership.
## Instructions
When given a weekly status report, follow these steps:
1. Read the entire report carefully.
2. Identify the top 3 accomplishments from the past week.
3. Identify any blockers or risks.
4. Note the top priorities for the coming week.
5. Write a summary that is exactly 5 sections:
- **Headline**: A one-sentence summary of the week.
- **Key Wins**: 3 bullet points, one sentence each.
- **Risks & Blockers**: 1-3 bullet points. If none, write
"No blockers this week."
- **Next Week Priorities**: 3 bullet points, one sentence each.
- **Action Items**: A numbered list of specific tasks with
owners and deadlines.
## Rules
- Keep the total summary under 200 words.
- Use plain language. No jargon or acronyms without explanation.
- Do not editorialize or add opinions. Stick to the facts in
the report.
- Bold all names and deadlines.
## Example Output
**Headline:** The team completed the new onboarding flow and
resolved the payment bug ahead of schedule.
**Key Wins:**
- Launched the redesigned onboarding flow for new users.
- Fixed the payment processing bug affecting 12% of transactions.
- Completed user interviews for the Q2 roadmap.
**Risks & Blockers:**
- Waiting on legal review for the new terms of service.
Expected by Friday.
**Next Week Priorities:**
- Begin development of the notification system.
- Finalize Q2 roadmap based on user interview data.
- Conduct performance testing on the new onboarding flow.
**Action Items:**
1. **Maria** — Send final onboarding flow metrics to leadership
by Tuesday.
2. **Carlos** — Follow up with legal on terms of service review
by Wednesday.
3. **Ana** — Schedule performance testing sessions by Thursday.

This skill file gives the AI everything it needs to produce a consistent, high-quality executive summary every single time.

Each platform has its own way of implementing skills and workflows. Here is how to create and use them on each platform we cover in this course.

Claude Code supports skills as Markdown files stored in your project.

How to create a skill:

  1. Create a .claude/skills/ folder in your project.
  2. Add a Markdown file for each skill (e.g., weekly-report.md).
  3. Write your skill instructions in the file using the anatomy described above.
  4. When you want to use the skill, tell Claude: “Use the weekly report skill to summarize this document.”

Claude Projects also support skills through the project’s instructions and knowledge base. You can upload reference documents and set instructions that act as persistent skills for every conversation in that project.

Skills in Claude Code are read from the file system, so they persist across sessions and can be version-controlled alongside your project files.

Example: A Skill That Always Formats Output the Same Way

Section titled “Example: A Skill That Always Formats Output the Same Way”

Let’s build a practical skill that demonstrates the power of consistent formatting. This skill takes any unstructured meeting notes and converts them into a standard format.

# Skill: Meeting Notes Formatter
## Description
Transform raw meeting notes into a clean, standardized format
suitable for sharing with the team.
## Instructions
When given unstructured meeting notes, produce output in
exactly this format:
### Meeting Summary
**Date:** [extract from notes or write "Not specified"]
**Attendees:** [list names found in notes, comma-separated]
**Duration:** [extract from notes or write "Not specified"]
### Key Discussion Points
- [Bullet point for each major topic discussed, one sentence each]
### Decisions Made
- [Bullet point for each decision, stating what was decided]
- If no decisions were made, write: "No formal decisions
were recorded."
### Action Items
| # | Task | Owner | Deadline |
|---|------|-------|----------|
| 1 | [task] | [name] | [date] |
If no deadlines were mentioned, write "TBD" in the
deadline column.
### Next Meeting
[Date and time if mentioned, otherwise "To be scheduled"]
## Rules
- Do not add information that is not in the original notes.
- If something is unclear, mark it with "[unclear]" rather
than guessing.
- Keep each bullet point to one sentence.
- Always include all five sections, even if some are empty.

Without this skill, every time you ask an AI to format meeting notes, you get a different structure. With this skill, you get the exact same format every time. Your team knows where to find the action items, the decisions, and the next steps. This consistency saves everyone time and reduces miscommunication.

Building Your First Skill: A Step-by-Step Approach

Section titled “Building Your First Skill: A Step-by-Step Approach”

Here is a practical process for building any skill from scratch.

Write a clear one-line description of what the skill does and when to use it.

“Turns a rough project idea into a structured one-page proposal with goals, timeline, budget estimate, and next steps.”

Start with the basics: what steps should the AI follow, what sections should the output include, and what rules apply.

Try the skill with at least five different inputs. Use easy ones and hard ones. Note where the output is inconsistent, missing information, or poorly formatted.

After each test, add rules to handle edge cases. Did the AI add information that was not in the input? Add a rule: “Do not add information not present in the source material.” Did it use an inconsistent format? Tighten the format instructions.

Save the final version in your platform’s skill format. Give it a clear, descriptive name so you can find it later.

Creating a skill takes more upfront effort than writing a quick prompt. But that effort pays for itself many times over:

  • You write the instructions once and use them dozens or hundreds of times.
  • Quality improves because you can refine the skill based on feedback, making each iteration better than the last.
  • Onboarding becomes easier because you can hand new team members a set of skills instead of explaining your processes verbally.
  • Output becomes predictable, which means you can build processes and workflows around AI output with confidence.
  • Skills are standardized, repeatable sets of instructions that produce consistent AI output. Workflows are multi-step skills.
  • A skill file contains a title, description, detailed instructions, rules, and optionally an example.
  • Every major platform supports skills in some form: Claude Code skills, ChatGPT Custom Instructions or Custom GPTs (paid), Gemini Gems (paid), Ollama Modelfiles, and LM Studio presets.
  • Skills solve three problems: inconsistency (different output every time), quality (mediocre results from vague prompts), and shareability (hard to distribute knowledge).
  • The upfront investment in creating a skill pays for itself quickly through reuse, consistency, and quality.
  • Start simple, test thoroughly, and refine over time using the self-modifying prompt pattern.