agentleFS
JsnnmscJsnnmsc/10000x-engineer/skills/scope/SKILL.md

scope

Skill2 starsChanged 2 months agoMITView on GitHub

Turn a vague feature request or task description into a clear scope — what's in, what's out, what's unknown, and how big it is.

42 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use frames, develop and 10 more.

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.
  • sanmidableSkill

    frames

    Also in 3 projects that use this

  • hong9LeeSkill

    develop

    빌드, 아키텍처, git 관련 작업 시 OMS MSA 공통 인프라 규칙을 적용한다. 기술 스택, 빌드 명령, 헥사고날 아키텍처 구조, git 워크플로우, AI Context 동기화 규칙을 다룬다. 코드 작성 컨벤션은 /convention, 테스트 컨벤션은 /test-guide 스킬을 참조.

    Also in 6 projects that use this

  • minhtran3124Skill

    visual

    Skill graph visualizer — scans all SKILL.md files in skills/, builds a directed relationship graph from explicit `relationships` frontmatter (falling back to content inference), and generates both a Mermaid markdown summary and an interactive HTML graph at .docs/skill-graph.html. Trigger: /visual

    Also in 3 projects that use this

  • MicrosoftSkill

    sync

    Sync the current session branch with its upstream branch, or publish the current session branch to a remote. Use when the user asks to sync a branch, pull latest changes, rebase onto upstream, push current branch, publish branch, or set upstream.

    Also in 7 projects that use this

  • nicolasestremSkill

    document

    Create focused documentation for specific components or features

    Also in 5 projects that use this

  • Skeln-ioSkill

    copy

    Direct response copywriting using proven frameworks. Brand-aware — reads ICP, voice, and tone from your brand config. Covers product descriptions, SEO meta, email, social, press angles.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 39 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the input is too vague to scope, list the clarifying questions instead.

    line 24
  2. Very specific:

    Don't put implementation steps in "In scope" — "add a reset_token column" is how, not what.

    line 69
  3. Distinctive:

    Don't fill "Out of scope" with things nobody would have assumed.

    line 72
  4. Distinctive:

    Don't hedge the complexity with a range ("S–M").

    line 75
  5. Distinctive:

    If no request was supplied, ask: "Paste the requirement or describe the task."

    line 77

“Common” is measured: kept by at least 6 in 10 of the 39 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

Scope

Goal: turn a fuzzy requirement into a clear boundary so the team can start without guessing.

Rules

  • Respond in the same language the user wrote in. If they write in Chinese, reply in Chinese. Technical terms (JWT, Redis, API…) stay in English.
  • Max 15 lines. Hard limit.
  • In scope = what must be built for this to be "done".
  • Out of scope = what people might assume is included but isn't. Be explicit.
  • Unknowns = questions that must be answered before work starts, not nice-to-know details.
  • Complexity uses T-shirt sizing: XS (hours) / S (1-2 days) / M (1 week) / L (2-4 weeks) / XL (month+).
  • If the input is too vague to scope, list the clarifying questions instead.
  • No emoji.

Output format

**In scope**
- [What must be built]
- [What must be built]

**Out of scope**
- [What to explicitly exclude]
- [What to explicitly exclude]

**Unknowns**
- [Question that blocks starting]
- [Question that blocks starting]

**Complexity:** [XS / S / M / L / XL] — [one-line reason]

Example

/scope 使用者可以用 email 連結重設密碼

**In scope**
- Request reset → send email with signed link
- Link expires after 1 hour, single use
- New password replaces old, existing sessions revoked

**Out of scope**
- SMS reset, OAuth re-auth
- Admin-triggered resets
- Password strength policy changes

**Unknowns**
- Which email service — existing SES setup or new?
- Should the old password be rejected as the new one?

**Complexity:** S — standard auth flow, no novel logic, one new table column

Anti-examples

Don't put implementation steps in "In scope" — "add a reset_token column" is how, not what. Scope is stated as user-visible outcomes.

Don't fill "Out of scope" with things nobody would have assumed. "Not building a blockchain" is noise; "no SMS reset" earns its line because someone will ask.

Don't hedge the complexity with a range ("S–M"). Pick one and say what would move it.

If no request was supplied, ask: "Paste the requirement or describe the task."

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.