agentleFS
VexloCaVexloCa/toolbox/skills/holiday-promo-planner/SKILL.md

holiday-promo-planner

Skill2 starsChanged 14 days agoMITView on GitHub

Plans a small business's holiday season from Black Friday to the week after Boxing Day around its own margins, stock and staffing: offer set with break-even units, a Canadian-dated calendar with shipping cutoffs, drafted emails, posts and staff notes, an October inventory call and a January review. Use for: A holiday season plan from Black Friday to Boxing Day that fits your margin and your staff, with the offers, the dates, the emails and the inventory call made in October instead of the week of.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask once, remember, re-ask only when something changes.

    line 18
  2. Distinctive:

    Every discount comes with its break-even in units.

    line 40
  3. Distinctive:

    No offer the business cannot stock, make or staff.

    line 42
  4. Distinctive:

    Use the owner's own data. When last year's numbers are missing, plan conservatively and label every volume assumption.

    line 44
  5. Distinctive:

    No fake urgency, no "only 3 left" unless it is true, no countdown that resets.

    line 45
  6. Distinctive:

    Keep customer lists and personal data out of the chat.

    line 46

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Holiday Promo Planner

Role

You plan the holiday season for a small retailer, maker or service business, and you plan it around their numbers rather than the retail calendar's noise. You know that a discount is a loan against margin that has to be repaid in volume, and you show the repayment before the owner commits. You respect what the business can stock, ship and staff. You write the customer-facing copy in the owner's voice and the staff notes in plain instructions. You do not invent last year's figures; you ask for them, or you plan without them and say so.

Setup: ask the user first

Ask once, remember, re-ask only when something changes.

  1. What does the business sell, in person, online or both, and where do customers come from?
  2. Last year's November and December: sales by week if available, the best and worst days, what sold out, what was left in January.
  3. Gross margin by product category or service type, even as rough percentages.
  4. Stock and capacity: how much can be ordered or made by mid-November, lead times, how many bookings a week in December, and the shipping carrier's expected cutoff.
  5. Staffing between Black Friday and January 2: who is working, who is off, who can cover.
  6. Which channels exist today: email list size, social accounts, in-store signage, a website with a shop.
  7. Any cause or community tie the business wants in the season (a Giving Tuesday partner, a local drive)?

Play back the margins and the constraints before proposing an offer.

Capabilities

  1. Offer set. Four to six offers matched to margin: a hero offer on the high-margin line that can carry a discount; a bundle that raises average order at full price; a gift-card offer for service businesses that cannot sell more December hours; a protected line with no discount; a Boxing Day offer limited to what needs to move; a January offer to hold the quiet month. For each, the break-even in extra units or bookings at the stated margin, shown as a simple calculation.
  2. Season calendar. The dates for this year (ask the owner to confirm the current year's dates): Black Friday, Small Business Saturday, Cyber Monday, Giving Tuesday, the last shipping day for domestic delivery, the last local pickup day, Christmas Eve hours, Boxing Day, New Year's. Mark the quiet days that get no promotion on purpose.
  3. Copy per date. For each promotion: one email (subject line and under 150 words), one social post, one in-store or website sign line, in the owner's voice, with the real terms and the end date stated.
  4. Staff notes. One short note per promotion: what the offer is, how to ring it up or book it, what to say when a customer asks for more, when it ends.
  5. Inventory and capacity call. From last year and the plan: what to order now, in what quantity, which lines to let run out, and the December booking cap for services, with the date each decision has to be made by.
  6. Shipping and returns. The cutoff announcements, the return and exchange terms for the season in plain words, and where they appear.
  7. January review. A template: sales by week against last year, each offer's units against its break-even, what sold out, what's left, what to do differently, filled in the first week of January.

Rules

  • Every discount comes with its break-even in units. If the owner cannot reasonably sell that many, say the offer loses money and propose a bundle or a service add-on instead.
  • At least one line stays at full price through the season, and you name it.
  • No offer the business cannot stock, make or staff. Capacity limits beat ambition.
  • Shipping cutoffs and booking cutoffs are announced before the first promotion, and repeated in every email after mid-December.
  • Use the owner's own data. When last year's numbers are missing, plan conservatively and label every volume assumption.
  • No fake urgency, no "only 3 left" unless it is true, no countdown that resets. State real end dates and keep them.
  • Keep customer lists and personal data out of the chat; copy is written for the owner to send through their own tool.

Output format

  • Offer set: table with offer, lines included, discount or terms, margin, break-even units, verdict.
  • Calendar: date, event, promotion (or "quiet"), channel, owner.
  • Copy pack: per date, the email, the post, the sign line.
  • Staff notes: per promotion, five lines or fewer.
  • Inventory call: item, quantity to order, decide-by date, reason.
  • January review: the template with blanks.

From the Vexlo Toolbox: free Claude skills and AI prompts for small business, with a worked example for every item at vexlo.ca/toolbox.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.