Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope.

MITAuto-check: notesMobile

Install Scope Framing

skills CLI
$ npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a claude-code

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

GitHub CLI
$ gh skill install ferrumclaudepilgrim/claude-code-android scope-framing --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/ferrumclaudepilgrim/claude-code-android.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/scope-framing .claude/skills/scope-framing && 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
scope-framing
GitHub stars
266
Token cost
~552 tokens
SKILL.md length
292 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope.

  • Mobile work in your project
  • SKILL.md covers Required Questions and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Scope Framing is an agent skill from ferrumclaudepilgrim/claude-code-android. Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope. Prevents research that answers the technically correct question but not the operationally relevant one.

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with Android and Node.js. The repository describes itself as: Run Claude Code natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required. The licence is MIT.

When your agent uses it

  • Mobile work in your project

Example prompts

  • “/scope-framing”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, Glob, Grep

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • Glob
    • Grep

    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

Scope Framing loads about 552 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 292 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~552

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Glob, Grep

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 ferrumclaudepilgrim/claude-code-android at commit cf30402, republished under its MIT licence (© ferrumclaudepilgrim). 292 words, ~552 tokens.

Download SKILL.mdSave it as .claude/skills/scope-framing/SKILL.md (or your agent's skills folder).
name
scope-framing
description
Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope. Prevents research that answers the technically correct question but not the operationally relevant one.
allowed-tools
Read, Bash, Glob, Grep
user-invocable
true
disable-model-invocation
false
argument-hint
<research topic>

Scope Framing

Answer every question before starting research. Write the answers into a brief scope document: one paragraph or a short list per question. Then proceed. If you cannot answer question 1, ask the user before starting.

Required Questions

1. What decision will this research serve? One sentence. Name the decision that will change based on what you find. If no decision is downstream of this research, the research has no purpose. Example: "Whether to use package X or build a custom implementation."

2. Who will act on the findings? Name the actor: a user, an agent, or another system. Different actors need different formats and levels of detail. An agent needs a recommendation. A decision-maker needs tradeoffs. Someone following instructions needs steps.

3. What does "done" look like? Name the specific deliverable that closes this research. Not "I understand the topic" but "a one-page comparison of options A, B, and C with a recommendation." Research without a defined end state expands forever.

4. What is explicitly out of scope? Name at least 2 things you will not research. Naming exclusions forces a scope decision and prevents drift. If you cannot name exclusions, your scope is not defined yet.

5. What would make this research useless? Identify failure modes before you start. Common causes: wrong scope (you answered a related but different question), stale data (the information is outdated for the version in use), missing context (you don't have access to a key constraint that changes the answer).

Output

Write the scope document before doing any research. Save it or include it at the top of your research output. If scope cannot be defined (if question 1 has no answer), stop and ask the user to clarify the decision before you proceed.

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

Files

Just SKILL.md in .claude/skills/scope-framing of ferrumclaudepilgrim/claude-code-android.

Open the folder on GitHubat commit cf30402

Compare with similar skills

Scope Framing 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.

Scope Framing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scope Framing this skillferrumclaudepilgrim/claude-code-android266—~552Automated safety check: NotesMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Android Hidden API and R8 Checkgkd-kit/gkd43k—~1.5kAutomated safety check: PassGPL-3.0
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0
Android Readme Screenshot Studiopermissionlesstech/bitchat-android7.8k—~3kAutomated safety check: PassGPL-3.0
Mobilerun Docs Referencedroidrun/mobilerun9.6k—~943Automated safety check: PassMIT

Similar skills

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Checks whether Android hidden-API implementations and system callbacks survive R8 minification, and diagnoses Release-only failures such as AbstractMethodError.

    43k GitHub stars~1.5k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated 2 days ago
    MobileAuto-check passed
  • Android Readme Screenshot Studio

    permissionlesstech/bitchat-android

    Create or refresh polished, high-resolution screenshots of the Bitchat Android app for README and repository showcase use.

    7.8k GitHub stars~3k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Mobilerun Docs Reference

    droidrun/mobilerun

    Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.

    9.6k GitHub stars~943 tokensUpdated 3 days ago
    MobileAuto-check passed
  • App Store Screenshots Generator

    ParthJadhav/app-store-screenshots

    Scaffolds a Next.js editor for designing App Store and Google Play screenshots as ads and exporting them at every required size, for iOS, Mac and Android.

    7.2k GitHub stars~14k tokensUpdated yesterday
    MobileAuto-check passed

More from ferrumclaudepilgrim/claude-code-android

  • Termux Safe

    ferrumclaudepilgrim/claude-code-android

    Android/Termux constraints reference. An agent skill from ferrumclaudepilgrim/claude-code-android.

    266 GitHub stars~935 tokensUpdated 2 mo ago
    Auto-check passed
  • Minimum Viable

    ferrumclaudepilgrim/claude-code-android

    Before building anything, justify the tool choice and complexity level.

    266 GitHub stars~538 tokensUpdated 2 mo ago
    Auto-check: notes

Works with

Categories

Questions about Scope Framing

What does Scope Framing do?

Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope. Scope Framing is an agent skill from ferrumclaudepilgrim/claude-code-android. Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope.

When should I use Scope Framing?

Scope Framing fits situations like: mobile work in your project.

How do I install Scope Framing in Claude Code?

Run `npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a claude-code`. Or copy the skill folder (.claude/skills/scope-framing in ferrumclaudepilgrim/claude-code-android) into .claude/skills/scope-framing in your project. Claude Code loads it when a task matches its description.

How do I install Scope Framing in Codex?

Run `npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a codex`. Or copy the skill folder (.claude/skills/scope-framing in ferrumclaudepilgrim/claude-code-android) into .agents/skills/scope-framing in your project. Codex loads it when a task matches its description.

Can I use Scope Framing 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 ferrumclaudepilgrim/claude-code-android --skill scope-framing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scope-framing, .gemini/skills/scope-framing, .github/skills/scope-framing and .opencode/skills/scope-framing in your project.

What does Scope Framing need to run?

SKILL.md names no scripts, command-line tools or credentials: Scope Framing is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, Glob, Grep.

Does Scope Framing 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 Scope Framing safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Scope Framing use?

Scope Framing 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 Scope Framing use?

About 552 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Scope Framing?

Skills that share tags, products or a category with Scope Framing: Engine Whats New (flutter/flutter, 179k stars), Android Hidden API and R8 Check (gkd-kit/gkd, 43k stars), Android API Diff (gkd-kit/gkd, 43k stars) and Android Readme Screenshot Studio (permissionlesstech/bitchat-android, 7.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scope Framing?

ferrumclaudepilgrim (a GitHub user) maintains it in ferrumclaudepilgrim/claude-code-android, which has 266 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on July 27, 2026.

Source: ferrumclaudepilgrim/claude-code-android on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.