Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence.

MITAuto-check: notes

Install Workplan

skills CLI
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill workplan -a claude-code

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

GitHub CLI
$ gh skill install AlpacaLabsLLC/skills-for-architects workplan --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/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/workplan .claude/skills/workplan && 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
workplan
GitHub stars
373
Token cost
~1.2k tokens
SKILL.md length
578 words
Files
4
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence.

  • Plan substantial work
  • SKILL.md covers Durable plan and Before changing records
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Coordinate an approved team

What it does

Workplan is an agent skill from AlpacaLabsLLC/skills-for-architects. Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence. Use to plan substantial work or coordinate an approved team; a plan-only request does not authorize implementation.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `README.md`, `host-contract.json` and `templates/plan.md`).

The repository describes itself as: Claude Code skills for architecture, real estate, and workplace strategy. Type /skill-name and go. The licence is MIT.

When your agent uses it

  • Plan substantial work
  • Coordinate an approved team
  • A plan-only request does not authorize implementation

Example prompts

  • “/workplan”

Requirements

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

What it can do on your machine

Read from SKILL.md and the folder at commit 657bfd5. 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
    • Write
    • Edit
    • Glob
    • Grep
    • Bash
    • AskUserQuestion

    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

Workplan loads about 1.2k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 578 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~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: 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, Write, Edit, Glob, Grep, Bash, AskUserQuestion

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 AlpacaLabsLLC/skills-for-architects at commit 657bfd5, republished under its MIT licence (© AlpacaLabsLLC). 578 words, ~1,233 tokens.

Download SKILL.mdSave it as .claude/skills/workplan/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
workplan
description
Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence. Use to plan substantial work or coordinate an approved team; a plan-only request does not authorize implementation.
allowed-tools
Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion

/as:workplan

Before acting, read the host contract, this component's declaration (skill:workplan), and applicable workspace semantics. Load only the required modes from the shared catalog.

<!-- architecture-studio:harness-compatibility -->

Use the host adapter and available native tools or ordinary task-specific code. Apply the receive-owned semantic document rules directly; no installed library, nested skill invocation, runner or executable reconstruction is required. Resolve context before durable work. Existing exact authorization persists; ask only for material missing information or missing permission.

Plan work, not a building/site/floor design. Route regulated/domain analysis to its proper owner. Inspect only enough evidence to make the plan reliable; distinguish facts from assumptions. Use applicable originals for external claims.

Quick straightforward tasks proceed within existing authorization. Meaningful multistep work that benefits from advance review receives a concise inline plan: intended result, concrete steps/outputs, relevant dependencies and checks. A durable plan is needed only when requested or useful for project continuity; do not create a file as an invocation tax. No rigid time threshold or compulsory Norma hop applies.

When parallel work benefits the task, state team size, roles, bounded assignments, concurrent work/dependencies, exclusive file ownership and integrator. Obtain only missing approval of that concrete work/team. Plan-only requests end at the plan. Prior exact approval survives resume. The main harness creates approved agents through actual exposed tools, verifies their identities and integrates results; workers return questions to the main loop. Unavailable/failed delegation is disclosed; only a material unapproved fallback needs further approval.

Durable plan

Resolve one project and read relevant PROJECT.md facts, registered decisions/source documents and the Agreement section when present. Compare scope advisory findings without creating commercial gates. Choose enough detail for the task; the plan template is a useful structure, not a required heading/word quota.

Each work unit names its result, owner, affected surface, inputs/dependencies and meaningful acceptance evidence. Include known risks/unknowns that change execution. Never inflate a small task with a committee, duplicate registry, blanket benchmark or mandatory deterministic validator.

Show full SKILL.md (260 more words)Show less

Before changing records

Before persistent changes, follow the native mutation sequence: Inspect → Prepare → Verify preparation → Apply → Verify result → Complete. Inspect pending work first. Finish and verify preparation before the first canonical write: separately reread every saved original and prepared file, check its complete actual bytes, establish durable saving, and inspect actual permissions, ownership and ACLs. Merely writing recovery files does not finish verification. Apply only that verified set. Mark complete only after fresh readback validates the entire affected result and its relationships. Read-only requests and inline drafts need no publication sequence.

Saving a plan affects the complete plan document plus DOCUMENTS.csv and any explicitly authorized attachment registrations. Prepare and verify that full set before writing the first member. Selected source records remain read guards. Plan publication does not include task import or implementation of the planned work.

Prepare Markdown; resolve confirmed document coordinates using documents.resolve; receive with kind plan. Paths follow the firm template. A revision is a new registered document with explicit supersedes, preserving the earlier plan. Reopen and report the actual document ID/path and remaining decisions.

Task register entries, project facts and durable decisions are separate promotions. Offer only useful selected handoffs; a saved plan does not silently import tasks or execute the work. Inline planning does not imply durable archival of conversation.

workplan.prepare means the authored preparation procedure above; it may produce an inline draft without a workspace write. Persistence uses the shared native document contract, restricted here to kind plan and authorized attachments. A saved record does not authorize its proposed actions or promote facts/decisions automatically.

© AlpacaLabsLLC, 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 3 other files in skills/workplan of AlpacaLabsLLC/skills-for-architects.

  • SKILL.md
  • README.md
  • host-contract.json
  • templates/plan.md

Open the folder on GitHubat commit 657bfd5

Compare with similar skills

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

Workplan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workplan this skillAlpacaLabsLLC/skills-for-architects373—~1.2kAutomated safety check: NotesMIT
Dependency Scanningsickn33/agentic-awesome-skills47k1 repos~2.4kAutomated safety check: PassMIT
Dependency Checkruvnet/ruflo74k—~258Automated safety check: PassMIT
Dependency Updatecodewhale-hq/Codewhale41k—~142Automated safety check: PassMIT
Os Step By Stepkharmanskyi/open-steps1.2k—~1.9kAutomated safety check: PassMIT
Bump Sentry Dependencygetsentry/sentry46k—~815Automated safety check: PassCustom licence

Similar skills

  • Dependency Scanning

    sickn33/agentic-awesome-skills

    Scan package dependencies for known vulnerabilities using Snyk, Dependabot, and OWASP Dependency-Check.

    47k GitHub starsUsed in 1 repo~2.4k tokens
    SecurityAuto-check passed
  • Dependency Check

    ruvnet/ruflo

    Scan project dependencies for known vulnerabilities and CVEs.

    74k GitHub stars~258 tokensUpdated today
    SecurityAuto-check passed
  • Dependency Update

    codewhale-hq/Codewhale

    Read release notes/changelogs, update a defined dependency scope, handle breaking changes, and verify.

    41k GitHub stars~142 tokensUpdated today
    DevelopmentAuto-check passed
  • Os Step By Step

    kharmanskyi/open-steps

    ALWAYS invoke this skill when you need the user to act - run a command, paste a secret, click, approve - and whenever they ask how to do something or say they do not know what to do: "step by step"…

    1.2k GitHub stars~1.9k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Bump Sentry Dependency

    getsentry/sentry

    Official

    Bumps an existing Python dependency in getsentry/sentry through the repository's self-serve GitHub Actions workflow.

    46k GitHub stars~815 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Audit, plan, and refresh dependency upgrades for the Logseq repository by scanning every non-gitignored package.json, deps.edn, bb.edn and nbb.edn manifest, checking latest upstream versions…

    45k GitHub stars~1.1k tokensUpdated today
    Knowledge ManagementAuto-check passed

More from AlpacaLabsLLC/skills-for-architects

All 60 skills in this repo
  • Receive

    AlpacaLabsLLC/skills-for-architects

    Register received or authored project documents by confirmed coordinates, preserve their filenames and provenance, and find or verify registered documents.

    373 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check: notes
  • Color Palette Generator

    AlpacaLabsLLC/skills-for-architects

    Create an HTML color palette from a mood, description, or image, with swatches, color codes, pairings, and contrast checks.

    373 GitHub stars~2.4k tokensUpdated 3 days ago
    Auto-check passed
  • Demographics Analysis

    AlpacaLabsLLC/skills-for-architects

    Research population, income, age, housing, and employment around a site.

    373 GitHub stars~2.4k tokensUpdated 3 days ago
    Auto-check: notes
  • Environmental Analysis

    AlpacaLabsLLC/skills-for-architects

    Research climate, sun, flood, seismic, soil, contamination, and topography for a site.

    373 GitHub stars~2.7k tokensUpdated 3 days ago
    Auto-check: notes
  • Mobility Analysis

    AlpacaLabsLLC/skills-for-architects

    Research transit, walking, cycling, pedestrian infrastructure, and airport access for a site.

    373 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check: notes
  • Product Data Cleanup

    AlpacaLabsLLC/skills-for-architects

    Clean a local FF&E CSV schedule by normalizing casing, dimensions, units, language, materials, and formatting.

    373 GitHub stars~4.3k tokensUpdated 3 days ago
    Auto-check: notes

Questions about Workplan

What does Workplan do?

Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence. Workplan is an agent skill from AlpacaLabsLLC/skills-for-architects. Prepare a proportionate work plan with outcomes, steps, dependencies and acceptance evidence.

When should I use Workplan?

Workplan fits situations like: plan substantial work; coordinate an approved team; A plan-only request does not authorize implementation.

How do I install Workplan in Claude Code?

Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill workplan -a claude-code`. Or copy the skill folder (skills/workplan in AlpacaLabsLLC/skills-for-architects) into .claude/skills/workplan in your project. Claude Code loads it when a task matches its description.

How do I install Workplan in Codex?

Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill workplan -a codex`. Or copy the skill folder (skills/workplan in AlpacaLabsLLC/skills-for-architects) into .agents/skills/workplan in your project. Codex loads it when a task matches its description.

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

What does Workplan need to run?

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

Does Workplan 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 Workplan 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 Workplan use?

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

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Workplan?

Skills that share tags, products or a category with Workplan: Dependency Scanning (sickn33/agentic-awesome-skills, 47k stars), Dependency Check (ruvnet/ruflo, 74k stars), Dependency Update (codewhale-hq/Codewhale, 41k stars) and Os Step By Step (kharmanskyi/open-steps, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workplan?

AlpacaLabsLLC (a GitHub organization) maintains it in AlpacaLabsLLC/skills-for-architects, which has 373 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 5, 2026.

Source: AlpacaLabsLLC/skills-for-architects on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.