All skills
simota avatar

/sherpa

@35ffd55
by shingo imotasimota/agent-skills85 stars
15

Guiding workflows by decomposing complex tasks (Epics) into Atomic Steps under 15 minutes each, with progress tracking and drift prevention. Use when complex decomposition is needed.

Use this Skill: https://skilld.dev/gh/simota/agent-skills/sherpa

This session only. Nothing lands on disk.

referenceanti-drift.md

≈474 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Anti-Drift Framework

Purpose: Use this file when the current step is losing focus, expanding scope, or attracting distractions.

Contents

  • Drift indicators
  • Detection keywords
  • Refocus prompt
  • Yak-shaving prevention rules
  • Parking Lot template

Drift Indicators

Signal Pattern Example
Scope creep “While I'm here, I should also...” “Let me also refactor this class.”
Perfectionism “It would be better if...” “Let me add more edge cases first.”
Rabbit hole “First I need to understand...” “Let me read every doc first.”
Shiny object “I noticed that...” “There is a bug in the footer.”
Premature optimization “This could be faster if...” “Let me add caching first.”

Detection Keywords

Watch for:

while I'm here
might as well
before I forget
quick detour
by the way
I noticed that
let me also
should probably
one more thing
real quick

Refocus Prompt

## Refocus Alert

**Current Step**: [Step Name]
**Detected**: [Drift type]
**Trigger**: "[user or self prompt]"

**Options**:
1. **Note and continue** (Recommended)
2. **Quick fix** (< 2 min)
3. **Pause and switch**

**Reminder**: The current step is [X]% complete.

Yak-Shaving Prevention Rules

1. New task appears -> add to backlog, do not start it
2. "Quick fix" > 2 min -> not quick, add it to Parking Lot
3. Current step < 80% complete -> finish it first
4. Unrelated to the current Epic -> definitely defer it
5. Truly blocked -> switch to a valid parallel task, not a random new one

Parking Lot

### Parking Lot

| Item | Source | Priority | Epic |
|------|--------|----------|------|
| "Footer bug" | Drift at 14:23 | P2 | New |
| "Add dark mode" | Drift at 15:01 | P3 | User Settings |
| "Refactor utils" | Drift at 15:30 | P2 | Tech Debt |

Source: SKILL.md on GitHub

No alerts13d5 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The skill provides a robust framework for decomposing complex tasks into manageable atomic steps, featuring extensive protocols for risk management and focus protection. No security issues were identified.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: LOW · No issues

  • Runlayer6mo

    1/11 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 35ffd55. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 2 weeks ago

README badge

README badge for simota/agent-skills/sherpa