agentleFS
serhiilenivserhiileniv/ccs/skills/pitch/SKILL.md

pitch

Skill0 starsChanged 12 days agoMITView on GitHub

Hackathon, after feature freeze. Audits the repo for what can be claimed, then writes a timed spoken pitch, a judge Q&A bank, a rehearsal sheet and the submission text, every claim backed by a file or command. User-invoked only.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use launch.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • MicrosoftSkill

    launch

    Launch and automate VS Code Insiders with the Copilot Chat extension using @playwright/cli via Chrome DevTools Protocol. Use when you need to interact with the VS Code UI, automate the chat panel, test the extension UI, or take screenshots. Triggers include 'automate VS Code', 'interact with chat', 'test the UI', 'take a screenshot', 'launch with debugging'.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 2 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every number in every later file must appear in Can claim.

    line 27
  2. Very specific:

    Write hackathon/script.md, for speaking, not reading.

    line 36
  3. Very specific:

    Every cut line goes to Q&A.

    line 60
  4. Very specific:

    Write hackathon/qa.md. One row per question, sorted by likelihood:

    line 64
  5. Very specific:

    Write hackathon/submission.md: Devpost/README copy.

    line 88
  6. Distinctive:

    Before ending, check and print pass/fail per line:

    line 94
  7. Very specific:

    every number in script, Q&A and submission is in facts.md

    line 98

“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “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

/ccs:pitch

Judges score the first 30 seconds, remember one sentence, and punish one exaggeration. This writes a pitch that survives all three.

Reads hackathon/plan.md (from /ccs:brief) and hackathon/demo.md (from /ccs:demo) if present. Missing plan → ask for the rubric and deadline; never invent criteria.

Step 1 — facts

Audit in code, not docs. Write hackathon/facts.md at the current <sha>:

ColumnRule
Can claimEach line: the claim, the number, and the file or command that proves it. Run the command.
Mocked / replayedWhat's simulated, seeded or replayed, and how it shows in the demo.
Not builtPromised in docs or slides, absent in code.
Must not claimAnything a judge could disprove: "live" if shot in replay, "production", user counts you don't have.

Every number in every later file must appear in Can claim. This is the one source of truth.

Step 2 — proof map

Refresh the rubric table in plan.md: each criterion → demo moment + timestamp + file. A criterion with no proof is a gap: print it; fix it in the demo or name it as a weakness.

Step 3 — script

Write hackathon/script.md, for speaking, not reading. Word budget per section (English ≈ 130 words/min; Ukrainian: time it, it runs longer).

3 minutes:

TimeSectionRule
0:00–0:15What it is, for whomFirst sentence says what it is. No team intro, no title-slide chat.
0:15–0:35One user's painA named person, one concrete failure, one number.
0:35–2:20Demo to the wowOne path, real data, wow by 2:00 at the latest. Narrate outcomes, not clicks.
2:20–2:45Why trust itOne line on what's hard or safe ("the LLM proposes, code verifies"). Not the stack.
2:45–3:00The sentenceEnd on it. Never "any questions?".

5 minutes stretches the demo, not the setup. Video format: demo visible within 15 s, total ≤ 90% of the limit.

Include, somewhere, these three lines:

  • Built here: what was built during the event (judges check commits).
  • One weakness: named before anyone asks, with what you'd do next.
  • Contrast: old way vs new, one line ("Chatbots explain. X resolves.").

Step 4 — cut pass

  • ≤ 5 numbers, all yours, all in facts.md. No market-size numbers.
  • One idea per section. No feature list, no framework names, no terminal on screen.
  • Every cut line goes to Q&A. Log it in script.md under ## Cut.

Step 5 — Q&A

Write hackathon/qa.md. One row per question, sorted by likelihood:

| Question | H/M/L | Answer (≤ 20 words) | Proof | Bridge back to the strength |

Pre-fill at least 12 from the repo, at least one per group: real vs mocked ("is it live?", "what did you build this weekend?") · the user ("who exactly?", "what do they do today?") · business (who pays, bottom-up: price × customers; why the sponsor would fund it) · AI (model wrong? cost and latency per run? prompt injection? why not one prompt? eval?) · scale (what breaks at 100×? privacy?) · competition (vs a named incumbent) · next 2 weeks.

Unknown → "Don't know yet; here's how we'd measure it." Never a made-up number.

Step 6 — rehearsal sheet

Append to script.md:

  • 3 timed runs out loud; record each; cut whatever made you stumble.
  • Drill the first 30 s alone until it's automatic.
  • Cold read to someone outside: they must say back what it is and who it's for. If they can't, rewrite the first section.
  • Who talks, who drives the demo, the exact inputs to paste (type nothing new live).

Step 7 — submission

Write hackathon/submission.md: Devpost/README copy. The sentence, the problem, what it does, how it's built (one paragraph), what's real vs replayed, one section per sponsor prize with the exact integration, live link, video link, repo link.

Gate

Before ending, check and print pass/fail per line:

  • script fits the time at the word budget
  • first sentence says what it is
  • wow lands ≤ 2:00
  • every number in script, Q&A and submission is in facts.md
  • the three required lines are present
  • script ends on the sentence

A fail → fix it, check again. Then name the next command: /ccs:deck.

What the gate cannot check: whether it persuades. Rehearsal and a cold listener do.

Language

lang: uk → script, Q&A and rehearsal in Ukrainian; product names, ids, code and UI labels stay as in the product. Submission stays in the event's language.

Writing

One line where one line does. Answer first. State the fact, not the story behind it — no narrating what was tried, no paragraph restating the line above. Two things always stay: why a non-obvious decision was made, and what a check cannot do. Caveats and risks still get said, one line each.

Outcome: success = gate all pass · partial = files written, gate has fails the user accepted · failed = no facts.md.

Report

Last step, every run, whatever the outcome: write .ccs/reports/<skill>/<YYYY-MM-DD>-<slug>.md at the repo root, and add .ccs/ to .git/info/exclude if missing. One line per field, no secrets, tokens or customer data. Print the path.

---
skill: <skill>
date: <YYYY-MM-DD>
repo: <owner/name>
target: <argument, one line>
outcome: success | partial | failed
learned: false
---

Used: <tools, CLIs, MCPs, files that did the work>
Found: <the result, one or two lines>
Friction: <what slowed or blocked it; a user correction; "none">

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.