Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes.

MITAuto-check: notesSales & Support

Install Proposal

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

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

GitHub CLI
$ gh skill install AlpacaLabsLLC/skills-for-architects proposal --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/proposal .claude/skills/proposal && 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
proposal
GitHub stars
373
Token cost
~1.1k tokens
SKILL.md length
499 words
Files
6 (incl. references)
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes.

  • Tasks that involve Proposals and quotes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Proposal is an agent skill from AlpacaLabsLLC/skills-for-architects. Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes. Sending messages is separate authorization.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `README.md`, `host-contract.json` and `references/tc-library.md`).

It sits in Sales & Support, covering Proposals and quotes. 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

  • Tasks that involve Proposals and quotes

Example prompts

  • “/proposal”

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

Proposal loads about 1.1k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 499 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

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). 499 words, ~1,098 tokens.

Download SKILL.mdSave it as .claude/skills/proposal/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
proposal
description
Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes. Sending messages is separate authorization.
allowed-tools
Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion

/as:proposal

Before acting, read the host contract, this component's declaration (skill:proposal), 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. Operation names identify the semantic work in the workspace model, not installed functions or a script API. Resolve canonical context before durable work. No Arch Studio runner, package installation or executable reconstruction is required. Existing exact authorization persists; ask only for material missing information or missing permission.

Own documents of kind proposal. Resolve the project; never create a global proposal register. Use the proposal template, keeping exactly one nonempty issued-terms marker block. Capture normal-case title, date, explicit local revision, scope/fees/exclusions and user-selected terms. Unknowns remain TO CONFIRM; their presence is context, not an invented workflow gate. Use human Rev. NN and a safe received/authored filename; confirmed lineage uses supersedes.

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.

For proposal creation, prepare the complete proposal and DOCUMENTS.csv together, including destination absence. Lifecycle changes affect DOCUMENTS.csv; the proposal's actual raw bytes and issued-terms seal are read guards. Additional rendered outputs are separate registered documents with their own complete affected set. Do not publish a proposal first and prepare its register afterward.

The harness prepares the terms from authorized inputs and current applicable originals, then proposal.create registers the authored source under confirmed coordinates. Do not copy external clause libraries or portray local summaries as current legal authority. Assembled terms include: “These clauses are drafting guidance, not legal advice; have a licensed attorney review before signing.”

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

proposal.list/status/verify read the actual registered record and protected terms. proposal.send only records supplied send date/evidence and seals the exact issued terms; it never emails or uploads. proposal.set-status records accepted/declined/superseded with explicit evidence/date. Acceptance may seal a draft directly when an earlier send was not recorded; no mandatory proposal→agreement→invoice sequence is imposed. Never infer acceptance, payment or project status from activity.

Once sealed, changed terms require a new registered revision, not replacement of the stored checksum. Lifecycle evidence stays in registry history outside the issued block. Preserve malformed input and checksum failures without guessing repair. HTML letters may use a confirmed firm template or bundled proposal-letter template, but the registered Markdown terms remain canonical; register additional outputs as documents.

Agreement promotion cites the accepted proposal ID and protected checksum without copying it. Tasks/time/invoices and project facts retain their owners. Fresh readback and actual inspection support completion; a recorded send event does not prove that any message was actually sent.

© 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 5 other files (references) in skills/proposal of AlpacaLabsLLC/skills-for-architects.

  • SKILL.md
  • README.md
  • host-contract.json
  • references/tc-library.md
  • templates/proposal-letter.html
  • templates/proposal.md

Open the folder on GitHubat commit 657bfd5

Compare with similar skills

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

Proposal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proposal this skillAlpacaLabsLLC/skills-for-architects373—~1.1kAutomated safety check: NotesMIT
Doc Coauthoringaws-samples/sample-strands-agent-with-agentcore19540 repos~3.2kAutomated safety check: PassMIT
Audit Onboarding Proposalhoangnb24/repository-harness1.2k—~4kAutomated safety check: PassMIT
No Negative EchoLB623/no-negative-echo897—~965Automated safety check: PassMIT
GEO Service Proposal Generatorzubair-trabzada/geo-seo-claude11k—~3kAutomated safety check: NotesMIT
Architectural ProposalsFritzAndFriends/SharpSite1452 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    195 GitHub starsUsed in 40 repos~3.2k tokens
    Sales & SupportAuto-check passed
  • Audit Onboarding Proposal

    hoangnb24/repository-harness

    Use only when the user explicitly invokes $audit-onboarding-proposal.

    1.2k GitHub stars~4k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • No Negative Echo

    LB623/no-negative-echo

    Prevent 此地无银三百两式 residue: finalize artifacts without echoing rejected session-only alternatives into labels, metadata, commits, PRs, or handoffs.

    897 GitHub stars~965 tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • GEO Service Proposal Generator

    zubair-trabzada/geo-seo-claude

    Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.

    11k GitHub stars~3k tokensUpdated yesterday
    Sales & SupportAuto-check: notes
  • Architectural Proposals

    FritzAndFriends/SharpSite

    How to write comprehensive architectural proposals that drive alignment before code is written

    145 GitHub starsUsed in 2 repos~1.6k tokens
    Sales & SupportAuto-check passed
  • Task Profile

    techwolf-ai/ai-first-toolkit

    Mine the user's Claude Code + Cowork session history into a structured task profile, what they do with AI, how often, how successfully where friction lives, then propose atomic skills that would…

    132 GitHub stars~3.6k tokensUpdated 9 days ago
    Sales & SupportAuto-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 2 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 2 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 2 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 2 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 2 days ago
    Auto-check: notes

Categories

Questions about Proposal

What does Proposal do?

Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes. Proposal is an agent skill from AlpacaLabsLLC/skills-for-architects. Draft and register project proposals, protect issued terms, and record explicitly evidenced commercial lifecycle changes.

When should I use Proposal?

Proposal fits situations like: tasks that involve Proposals and quotes.

How do I install Proposal in Claude Code?

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

How do I install Proposal in Codex?

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

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

What does Proposal need to run?

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

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

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

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 742 tokens, read only when the agent opens those files.

What are the alternatives to Proposal?

Skills that share tags, products or a category with Proposal: Doc Coauthoring (aws-samples/sample-strands-agent-with-agentcore, 195 stars), Audit Onboarding Proposal (hoangnb24/repository-harness, 1.2k stars), No Negative Echo (LB623/no-negative-echo, 897 stars) and GEO Service Proposal Generator (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proposal?

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.