Agent skill

Pivot

by MAGA2010 in MAGA2010/hackathon-run

Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress.

MITAuto-check passed

Install Pivot

skills CLI
$ npx skills add MAGA2010/hackathon-run --skill pivot -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MAGA2010/hackathon-run pivot --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MAGA2010/hackathon-run.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pivot .claude/skills/pivot && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pivot
GitHub stars
390
Token cost
~981 tokens
SKILL.md length
385 words
Files
2 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress.

  • Works in 3 steps: Read every state file → Compute preserve / drop / rewrite → Emit a pivot report
  • The user says pivot
  • SKILL.md covers Input contract, Execution, Output contract and Acceptance criteria, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pivot is an agent skill from MAGA2010/hackathon-run. Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress. Use when the user says pivot, change direction, or after a flat demo; do not invoke pre-build.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/pivot-examples.md`).

The licence is MIT.

When your agent uses it

  • The user says pivot
  • Change direction
  • After a flat demo
  • Do not invoke pre-build

Example prompts

  • “Use the pivot skill to detect a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress”
  • “/pivot”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Read every state file
  2. Compute preserve / drop / rewrite
  3. Emit a pivot report

What it can do on your machine

Read from SKILL.md and the folder at commit de3bcfb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pivot loads about 981 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 385 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~981
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MAGA2010/hackathon-run at commit de3bcfb, republished under its MIT licence (© MAGA2010). 385 words, ~981 tokens.

Download SKILL.mdSave it as .claude/skills/pivot/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pivot
description
Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress. Use when the user says pivot, change direction, or after a flat demo; do not invoke pre-build.
when_to_use
Trigger when the user says "pivot", "change direction", "the demo idea is wrong", or after a demo that landed flat with judges. Do not invoke pre-build…
version
1
category
scoping
tags
mid-build-redirect, cut-rewrite, preserves-keep
dependencies
scope-knife, decision-log
triggers
pivot, change direction, rebuild, mid-build redirect, start over

pivot

A pivot is the most expensive thing a hackathon team can do. Done wrong, it costs the team 4 hours and a working demo. Done right, it saves them from shipping something nobody wants.

This skill does the minimum work needed to redirect the team without losing prior state.

Input contract

Required:

  • new_direction: one-sentence description of where the team is going now

Optional:

  • .hackathon/state/plan.json (if it exists, the pivot preserves KEEP features)
  • .hackathon/state/verify.json (last failure signatures — useful for the new plan)
  • .hackathon/state/review.json (judge feedback that triggered the pivot)
  • .hackathon/state/demo.json (current pitch — often the source of the pivot)
  • time_remaining_minutes: integer >= 0 (default: from plan.json if present)

Execution

1. Read every state file

If .hackathon/state/ exists, read all 5 files. For each, summarize in one line:

  • plan.json: how many KEEP features, what demo_path
  • verify.json: pass / fail / skipped counts, last failure signature
  • review.json: overall score, fix_now count
  • demo.json: duration, one_liner
  • ship.json: packaging status
2. Compute preserve / drop / rewrite

For every feature in the previous plan.json:

Previous statusDefault action
KEEP + still relevantpreserve
KEEP + no longer relevantcut, add to "lost" list
CUT or DEFERcut (no change)

Hard rule: at least 1 feature must survive unchanged, otherwise the pivot is actually a rewrite and the user should re-run scope-knife from scratch.

3. Emit a pivot report

Write .hackathon/artifacts/pivot-report.md with:

  • the one-line summary of every prior state file
  • the preserve/cut/rewrite table
  • the proposed new demo_goal (one sentence)
  • a recommended next-step: hackathon run scope-knife with the new brief
Show full SKILL.md (140 more words)Show less

Output contract

Files written:

  • .hackathon/artifacts/pivot-report.md (human-readable)

Like idea-clarify, this skill does NOT write to .hackathon/state/*.json. It prepares the team to re-run scope-knife with a fresh plan.

Acceptance criteria

  • Reads all 5 state files (or notes which are missing).
  • Computes preserve / cut / rewrite per previous feature.
  • At least 1 KEEP feature survives (otherwise refuse: "this is a rewrite, not a pivot").
  • pivot-report.md exists and is <= 1 page.

Failure modes

ModeBehavior
No plan.jsonRefuse: "nothing to pivot from; run scope-knife"
New direction is identicalRefuse: "no change; this isn't a pivot"
All KEEP features irrelevantRefuse: "this is a rewrite; run scope-knife fresh"
Time < 30 minRefuse: "no time to pivot safely"

Trigger phrases (for agent intent matching)

  • "pivot"
  • "change direction"
  • "the demo idea is wrong now"
  • "judges hated it"
  • "we are building the wrong thing"
  • "start over but keep X"

© MAGA2010, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/pivot of MAGA2010/hackathon-run.

  • SKILL.md
  • references/pivot-examples.md

Open the folder on GitHubat commit de3bcfb

Compare with similar skills

Pivot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pivot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pivot this skillMAGA2010/hackathon-run390—~981Automated safety check: PassMIT
Threat Detectionalirezarezvani/claude-skills28k—~3.5kAutomated safety check: PassMIT
Resemble Detectgithub/awesome-copilot40k3 repos~4.1kAutomated safety check: PassApache-2.0
Pii Detectruvnet/ruflo74k—~350Automated safety check: NotesMIT
Detecting Dnp3 Protocol Anomaliesmukul975/Anthropic-Cybersecurity-Skills34k—~3.6kAutomated safety check: PassApache-2.0
Detecting Attacks On Scada Systemsmukul975/Anthropic-Cybersecurity-Skills34k—~6.9kAutomated safety check: PassApache-2.0

Similar skills

  • Threat Detection

    alirezarezvani/claude-skills

    A skill your agent uses when hunting for threats in an environment, analyzing IOCs, or detecting behavioral anomalies in telemetry.

    28k GitHub stars~3.5k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Resemble Detect

    github/awesome-copilot

    Official

    Deepfake detection and media safety — detect AI-generated audio, images, video, and text, trace synthesis sources, apply watermarks, verify speaker identity, and analyze media intelligence using…

    40k GitHub starsUsed in 3 repos~4.1k tokens
    Media & CreativeAuto-check passed
  • Pii Detect

    ruvnet/ruflo

    Detect and flag personally identifiable information (PII) in text, code, and configurations.

    74k GitHub stars~350 tokensUpdated yesterday
    Auto-check: notes
  • Detecting Dnp3 Protocol Anomalies

    mukul975/Anthropic-Cybersecurity-Skills

    Detect anomalies in DNP3 communications used in SCADA/ICS systems by monitoring unauthorized control commands, firmware update attempts, protocol violations, and deviations from baseline traffic…

    34k GitHub stars~3.6k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Detecting Attacks On Scada Systems

    mukul975/Anthropic-Cybersecurity-Skills

    This skill covers detecting cyber attacks targeting Supervisory Control and Data Acquisition (SCADA) systems including man-in-the-middle attacks on industrial protocols, unauthorized command…

    34k GitHub stars~6.9k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Detecting AWS Cloudtrail Anomalies

    mukul975/Anthropic-Cybersecurity-Skills

    Detect unusual API call patterns in AWS CloudTrail logs using boto3, statistical baselining, and behavioral analysis to identify credential compromise, privilege escalation, and unauthorized…

    34k GitHub stars~751 tokensUpdated 1 mo ago
    SecurityAuto-check passed

More from MAGA2010/hackathon-run

All 15 skills in this repo
  • Decision Log

    MAGA2010/hackathon-run

    Writes every KEEP/CUT/DEFER/PIVOT scope decision into an append-only team log with rationale, author, and timestamp.

    390 GitHub stars~847 tokensUpdated 2 days ago
    Auto-check passed
  • Demo Coach

    MAGA2010/hackathon-run

    Drafts a 30, 60, or 90-second pitch script for the demo, structured as opening, pain, product, action, result, close.

    390 GitHub stars~895 tokensUpdated 2 days ago
    Auto-check passed
  • Judge Sim

    MAGA2010/hackathon-run

    Scores a hackathon project 0 to 5 across seven judging dimensions and produces a prioritized fix list for the last hour.

    390 GitHub stars~970 tokensUpdated 2 days ago
    Auto-check passed
  • Scope Knife

    MAGA2010/hackathon-run

    Forces a KEEP, CUT, or DEFER decision on every feature when scope is too large, no MVP consensus exists, or time is running out.

    390 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Time Box

    MAGA2010/hackathon-run

    Allocates time across the hackathon lifecycle (idea - scope - build - verify - demo - ship) and warns before each deadline slips.

    390 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Fast Verify

    MAGA2010/hackathon-run

    Verifies the demo path runs end-to-end by executing each step in order, recording the actual outcome, and stopping at the first failure with a diagnostic.

    390 GitHub stars~893 tokensUpdated 2 days ago
    Auto-check passed

Questions about Pivot

What does Pivot do?

Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress. Pivot is an agent skill from MAGA2010/hackathon-run. Detects a mid-build scope change and re-runs scope-knife against the new direction without losing prior progress.

When should I use Pivot?

Pivot fits situations like: the user says pivot; change direction; after a flat demo; do not invoke pre-build.

How do I install Pivot in Claude Code?

Run `npx skills add MAGA2010/hackathon-run --skill pivot -a claude-code`. Or copy the skill folder (skills/pivot in MAGA2010/hackathon-run) into .claude/skills/pivot in your project. Claude Code loads it when a task matches its description.

How do I install Pivot in Codex?

Run `npx skills add MAGA2010/hackathon-run --skill pivot -a codex`. Or copy the skill folder (skills/pivot in MAGA2010/hackathon-run) into .agents/skills/pivot in your project. Codex loads it when a task matches its description.

Can I use Pivot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MAGA2010/hackathon-run --skill pivot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pivot, .gemini/skills/pivot, .github/skills/pivot and .opencode/skills/pivot in your project.

What does Pivot need to run?

SKILL.md names no scripts, command-line tools or credentials: Pivot is instructions for the agent only.

Does Pivot access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pivot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pivot use?

Pivot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pivot use?

About 981 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 223 tokens, read only when the agent opens those files.

What are the alternatives to Pivot?

Skills that share tags, products or a category with Pivot: Threat Detection (alirezarezvani/claude-skills, 28k stars), Resemble Detect (github/awesome-copilot, 40k stars), Pii Detect (ruvnet/ruflo, 74k stars) and Detecting Dnp3 Protocol Anomalies (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pivot?

MAGA2010 (a GitHub user) maintains it in MAGA2010/hackathon-run, which has 390 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: MAGA2010/hackathon-run on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.