How to Build a Skill for the ProductiveBot Skill Store

Think about the last time you got your ProductiveBot to do something really useful. Maybe you figured out how to automate your invoicing. Or you set up a workflow that turns voice memos into organized meeting notes. Or you built a system that tracks your inventory across three suppliers.

That thing you figured out? Other people need it too. And they'd pay for it.

The ProductiveBot Skill Store lets you package what you know into a skill that other customers can install with one click. You set the price. You get paid when people buy it. And the best part: a skill is mostly just a set of clear instructions in a text file.

What a Skill Actually Is

A skill is a folder with one required file: SKILL.md. That's it at its simplest.

Your bot reads this file and follows the instructions inside it. Think of it like writing a really detailed how-to guide for someone who's smart but has never done this specific task before. That someone just happens to be an AI.

Here's what a basic skill folder looks like:

my-skill/
├── SKILL.md          (required — the instructions)
├── scripts/          (optional — any code that needs to run)
├── references/       (optional — extra docs or data)
└── assets/           (optional — templates, images, files)

Most skills don't need scripts or assets. The instructions in SKILL.md do the heavy lifting.

Writing Your SKILL.md

Every SKILL.md has two parts: a short header and the instructions.

The Header

The header tells ProductiveBot what your skill is and when to use it. It looks like this:

---
name: invoice-automator
description: Automate invoice creation and tracking for small businesses.
  Use when the customer asks about invoices, billing, payment tracking,
  or accounts receivable.
---

Two things matter here:

1. Name: Keep it short and descriptive. Lowercase, hyphens instead of spaces.
2. Description: This is how your bot decides whether to use the skill. Be specific about what it does and what kinds of requests should trigger it. List example phrases customers might say.

The Instructions

After the header, write the actual instructions in plain Markdown. Tell the bot what to do when the skill is triggered, what steps to follow in order, what to watch out for, and what to say to the customer at each step.

Here's a simple example:

# Invoice Automator

Create and track invoices for the customer's business.

## When to Use
Activate when the customer mentions invoices, billing,
creating quotes, or tracking payments.

## Creating a New Invoice
1. Ask the customer for: client name, items/services,
   amounts, and due date
2. Create the invoice as a clean PDF
3. Save it to ~/Documents/Invoices/
4. Tell the customer where you saved it

Notice how specific that is. You're not writing vague goals. You're writing step-by-step instructions that leave no room for guessing.

Tips for Writing Great Skills

Be specific, not vague

Your bot is smart, but it can't read your mind. "Handle invoices" is too vague. "Create a PDF invoice using the template in assets/, fill in the client name, line items, and total, and save it to ~/Documents/Invoices/" is what actually works.

Write it like you're training a new employee

Imagine someone on their first day. They're competent and eager, but they don't know your systems yet. What would you tell them? Write that.

Include what to say to the customer

Your skill can include suggested messages. This keeps the experience consistent and professional.

Add troubleshooting

Think about what might go wrong and tell the bot how to handle it. This makes your skill more reliable and saves customers from contacting support.

Keep the file lean

Your SKILL.md shares space with everything else your bot is thinking about. Don't pad it with background information the bot already knows. If you need to include detailed reference material, put it in a references/ folder and tell the bot to read it when needed.

Adding Scripts (Optional)

Some skills need to run actual code. Maybe you have a Python script that connects to an API, or a shell script that sets up a folder structure. Put those in a scripts/ folder and reference them in your SKILL.md.

Scripts should be self-contained and safe. They shouldn't require installing anything exotic or making changes that can't be undone.

Skill Ideas Based on Real Industries

Think about your own expertise. Here are some ideas based on what ProductiveBot customers actually do:

For tradespeople: Quote generators for plumbing, HVAC, or electrical jobs. Job scheduling and follow-up reminder systems. Materials calculators that estimate costs from a job description.

For e-commerce sellers: Product listing creators that format for multiple platforms. Inventory trackers that alert when stock is low. Return and refund workflows that handle customer communications.

For healthcare professionals: Patient intake form processors. Appointment reminder systems. Compliance checklists for documentation.

For freelancers and consultants: Project proposal generators. Time tracking and invoice workflows. Client onboarding checklists that gather everything upfront.

For real estate: Property listing description writers. Open house follow-up email sequences. Comparable market analysis formatters.

You don't need to build something that serves millions. A skill that saves 10 plumbers two hours a week is worth real money.

How to Submit Your Skill

Once your skill is working on your own ProductiveBot, here's how to get it into the store:

1. Test it thoroughly on your own bot. Install it, use it for real tasks, and make sure the instructions are clear enough that the bot follows them correctly every time.
2. Write a short description of what your skill does, who it's for, and what problem it solves.
3. Email it to us at support@productivebot.ai with your skill folder attached. Include your name, the price you want to charge, and your description.
4. We review it. Every skill in the store is vetted by the ProductiveBot team. We check that it works, it's safe, and the instructions are clear.
5. It goes live. Once approved, your skill appears in the Skill Store. Customers install it with one click. You get paid for every sale.

Start With What You Know

You don't need a computer science degree. You don't need to know how to code. You need two things: expertise in something (which you already have) and the ability to write clear instructions.

The Skill Store is how ProductiveBot customers turn their knowledge into income. The demand for specialized AI workflows is growing fast, and the people who build skills now will be the ones everyone else is buying from later.

Your ProductiveBot can help you write the skill, too. Just tell it: "Help me create a skill that does [what you want]." It knows the format and can draft the SKILL.md for you.

Ready to build your first skill? Open up your ProductiveBot and say: "Let's create a skill."

The ProductiveBot Skill Store is where customers share and sell the workflows that make their businesses run. Visit support.productivebot.ai/skills to browse available skills, or build your own and start earning. Need help? Talk to Scout or email support@productivebot.ai.