Agent skill

Scratchpad

by Effect-TS in Effect-TS/effect-smol

Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file.

MITAuto-check passedDevelopment

Install Scratchpad

skills CLI
$ npx skills add Effect-TS/effect-smol --skill scratchpad -a claude-code

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

GitHub CLI
$ gh skill install Effect-TS/effect-smol scratchpad --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/Effect-TS/effect-smol.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/scratchpad .claude/skills/scratchpad && 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
scratchpad
GitHub stars
782
Token cost
~459 tokens
SKILL.md length
216 words
Files
3 (incl. scripts)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file.

  • Works in 5 steps: Determine the source path and line → Run → If the script exits with code 2 because… → …
  • The user asks to dump
  • SKILL.md covers Workflow and Behavior
  • Runs JavaScript scripts from its folder; calls node

What it does

Scratchpad is an agent skill from Effect-TS/effect-smol. Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file. Use when the user asks to dump, copy, open, or try a source example in scratchpad.

Its SKILL.md is about 460 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `agents/openai.yaml`).

It sits in Development, covering Technical documentation. It works with TypeScript. The repository describes itself as: Core libraries and experimental work for Effect v4. The licence is MIT.

When your agent uses it

  • The user asks to dump
  • Try a source example in scratchpad

Example prompts

  • “/scratchpad”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Determine the source path and line
  2. Run
  3. If the script exits with code 2 because there is no obvious runner, ask the
  4. Report the created path as a clickable file link. This is the deterministic
  5. Do not run the scratchpad file unless the user explicitly asks.

What it can do on your machine

Read from SKILL.md and the folder at commit 3a1128c. 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

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    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

Scratchpad loads about 459 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 216 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Effect-TS/effect-smol at commit 3a1128c, republished under its MIT licence (© Effect-TS). 216 words, ~459 tokens.

Download SKILL.mdSave it as .claude/skills/scratchpad/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
scratchpad
description
Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file. Use when the user asks to dump, copy, open, or try a source example in scratchpad.

Use this skill to create a scratchpad TypeScript file from the JSDoc **Example** nearest the user's active source cursor or selection.

Workflow

  1. Determine the source path and line:

    • Use the IDE active file and selection/cursor line when present.
    • Use an explicit file and line when the user provides them.
    • If no line or selection is available, ask for it.
  2. Run:

    sh
    node .agents/skills/scratchpad/scripts/extract-example.mjs <source-path> <line>
  3. If the script exits with code 2 because there is no obvious runner, ask the user whether to preserve the example exactly, name an Effect value to run, or cancel.

    • To preserve exactly, rerun with --mode preserve.
    • To run a specific Effect value, rerun with --runner <identifier>.
  4. Report the created path as a clickable file link. This is the deterministic way to open it in the code pane.

  5. Do not run the scratchpad file unless the user explicitly asks.

Behavior

  • The script chooses the example whose **Example** section contains the line; otherwise it chooses the first following example; otherwise the nearest previous example.

  • Filenames are derived from the source file and example title, for example scratchpad/Schedule-retrying-and-repeating-effects.ts.

  • Existing files are not overwritten. The script appends a numeric suffix.

  • In auto mode, if a top-level program binding exists, the script appends:

    ts
    Effect.runPromise(program).then(console.log, console.error)
  • If the example already contains an Effect runner, the script preserves it.

© Effect-TS, 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 2 other files (scripts) in .agents/skills/scratchpad of Effect-TS/effect-smol.

  • SKILL.md
  • agents/openai.yaml
  • scripts/extract-example.mjs

Open the folder on GitHubat commit 3a1128c

Compare with similar skills

Scratchpad 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.

Scratchpad compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scratchpad this skillEffect-TS/effect-smol782—~459Automated safety check: PassMIT
Add Packageremix-run/remix33k—~2kAutomated safety check: PassMIT
evlog Enricher Creatorevloghq/evlog1.9k—~1.7kAutomated safety check: PassMIT
Enforce Rules For Typescriptmoeru-ai/airi50k—~3.4kAutomated safety check: PassMIT
Standard Jsdocbackpine/effect-worker-mono132—~1.3kAutomated safety check: PassMIT
Adk Readme WriterBrainDAO/adk-ts119—~2.6kAutomated safety check: NotesMIT

Similar skills

  • Add Package

    remix-run/remix

    Create or align a package in the Remix monorepo to match existing package conventions.

    33k GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Guides adding a new built-in enricher to the evlog package, covering the source, tests, docs, README, a related skill and a changeset.

    1.9k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Enforce AIRI's TypeScript and Vue source rules for imports, naming, comments, JSDoc, fallbacks, stateful and protocol code, and module design.

    50k GitHub stars~3.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Standard Jsdoc

    backpine/effect-worker-mono

    Write, insert, or update Effect public API JSDoc so it satisfies the standard-jsdoc oxlint rule.

    132 GitHub stars~1.3k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Adk Readme Writer

    BrainDAO/adk-ts

    ADK-TS README specialist. An agent skill from BrainDAO/adk-ts.

    119 GitHub stars~2.6k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Typedoc

    ankitskvmdam/clean-jsdoc-theme

    Expert guidance for the @clean-jsdoc-theme/typedoc plugin — using clean-jsdoc-theme v5 with TypeDoc / TypeScript.

    179 GitHub stars~3k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from Effect-TS/effect-smol

  • Jsdocs

    Effect-TS/effect-smol

    Write, insert, or update Effect public API JSDoc so it satisfies the jsdocs oxlint rule.

    782 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Grill Me

    Effect-TS/effect-smol

    Interview the user about a plan or design until reaching shared understanding, resolving each branch of the decision tree.

    782 GitHub starsUsed in 1 repo~504 tokens
    Auto-check passed

Works with

Categories

Questions about Scratchpad

What does Scratchpad do?

Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file. Scratchpad is an agent skill from Effect-TS/effect-smol./scratchpad as a TypeScript file.

When should I use Scratchpad?

Scratchpad fits situations like: the user asks to dump; try a source example in scratchpad.

How do I install Scratchpad in Claude Code?

Run `npx skills add Effect-TS/effect-smol --skill scratchpad -a claude-code`. Or copy the skill folder (.agents/skills/scratchpad in Effect-TS/effect-smol) into .claude/skills/scratchpad in your project. Claude Code loads it when a task matches its description.

How do I install Scratchpad in Codex?

Run `npx skills add Effect-TS/effect-smol --skill scratchpad -a codex`. Or copy the skill folder (.agents/skills/scratchpad in Effect-TS/effect-smol) into .agents/skills/scratchpad in your project. Codex loads it when a task matches its description.

Can I use Scratchpad 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 Effect-TS/effect-smol --skill scratchpad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scratchpad, .gemini/skills/scratchpad, .github/skills/scratchpad and .opencode/skills/scratchpad in your project.

What does Scratchpad need to run?

Going by SKILL.md and its folder, Scratchpad needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.

Does Scratchpad 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 Scratchpad 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Scratchpad use?

Scratchpad 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 Scratchpad use?

About 459 tokens (SKILL.md is roughly 1.8k 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 Scratchpad?

Skills that share tags, products or a category with Scratchpad: Add Package (remix-run/remix, 33k stars), evlog Enricher Creator (evloghq/evlog, 1.9k stars), Enforce Rules For Typescript (moeru-ai/airi, 50k stars) and Standard Jsdoc (backpine/effect-worker-mono, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scratchpad?

Effect-TS (a GitHub organization) maintains it in Effect-TS/effect-smol, which has 782 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on July 14, 2026.

Source: Effect-TS/effect-smol on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.