Skip to content

Guide · Agent skill

How to use the Proposal Writer agent skill (proposal-writer)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The Proposal Writer skill (proposal-writer) is an agent skill from the genoffice project that turns a requirement, idea or spoken brief into a reviewable project or solution proposal delivered as a Word document. This guide explains what an agent skill is, how to install this one from a ZIP or the Claude apps, how to trigger it with plain requests, and what it needs before it runs. By the end you will be able to ask for a proposal draft and know what the output will contain and what you still have to supply.

Proposal Writergenspark-ai/genoffice · Apache-2.0

Quick start

  1. 1Download the ZIP. Get the proposal-writer ZIP from the page you are reading.
  2. 2Unzip into a skills folder. Place the proposal-writer folder in ~/.claude/skills/ for all projects, or in the project's .claude/skills/ folder.
  3. 3Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities and then Skills, and upload the skill.
  4. 4Confirm a Word tool is available. Make sure your agent environment has a document tool that can produce a Word file.
  5. 5Make a request. Describe the proposal and paste your rough requirements, for example asking for a project proposal from these requirements.
  6. 6Answer the open questions. Answer the questions the agent asks about audience and approver, and supply any figures you have.
  7. 7Fill the TBD items. Review the open items list at the end and supply the data or decisions it names.

What is an agent skill and what does this one do?

An agent skill is a folder containing a SKILL.md file that gives an AI agent specialist instructions for a task. When the skill is installed, the agent follows its workflow instead of improvising.

This skill makes the agent work as a proposal-writing specialist. It first positions the proposal (internal approval, client-facing solution, or event or renovation plan) and identifies who reads and approves it. It then gathers the problem, measurable goals, constraints, alternatives and acceptance method, and drafts the full document.

  • Output is a Word document titled "<Project Name> Proposal vN".
  • Sections include a one-page summary, background and goals, solution design with an alternatives comparison, a milestone table, an itemised budget, a risks table and a list of decisions required.
  • Unknown figures are written as TBD, and estimates are marked "est." with their basis.
  • The skill ends by listing the two or three places where you most need to supply data or make a decision.

How do you install the Proposal Writer skill?

Download the ZIP for proposal-writer from the page where you found this guide. Unzip it so that the proposal-writer folder with its SKILL.md sits in one of these locations:

  • For all your projects: ~/.claude/skills/
  • For a single project: the project's .claude/skills/ folder
  • Or upload the skill in the Claude apps under Settings → Capabilities → Skills.
~/.claude/skills/proposal-writer/SKILL.md

How do you trigger the skill with a natural request?

You do not need a special command. Describe the document you want in plain language, and include your rough requirements in the same message. The SKILL.md lists two quick prompts you can start from.

If you give enough context, the agent will ask only the questions it cannot answer itself. Say who the proposal is for when you can, because it sets length and tone.

  • Write a project proposal from these requirements
  • Expand this idea into a solution document ready for review
  • Make a client-facing solution proposal for this quote, leaving out internal costs

What do you need before you start?

The skill needs a Word document tool available to the agent. The source refers to "document tools available here" but does not name a specific library or service, so check that your agent environment provides one before you rely on the .docx output.

The skill does not run scripts and does not use the network, according to its listing.

  • A Word document tool available to the agent
  • Your requirement or idea, even as rough notes or a spoken description
  • Any real figures you have for budget, timelines and headcount

What should you check for safety?

The listing states that the skill runs no scripts and uses no network access. Because it is a set of written instructions, review the SKILL.md yourself before installing it, as you would with any file you add to an agent.

The skill does not settle legal, licence or compliance questions. It writes "subject to local rules / company policy" in those places, so specialist review is still needed. Client-facing versions omit internal costs and margins by design.

What tips get better proposals?

Give measurable goals where you can. The skill is written to reject vague goals, so a figure such as a support-ticket reduction over a stated period is more useful than a general aim.

Provide an earlier version if one exists. The skill then compares differences first and keeps the original numbering and terminology.

Expect TBD placeholders when you have no numbers. The skill will not invent confident figures, so a draft with gaps is the intended result.

  • State the constraints: budget cap, time, headcount or compliance.
  • Name existing alternatives so the comparison is meaningful.
  • Check the alternative section: it states the conditions under which the alternative would be the better choice.

What people use it for

  • Drafting an internal project approval from rough meeting notes.
  • Preparing a client-facing solution document that shows quote and delivery commitments without internal cost details.
  • Turning a spoken idea into a reviewable proposal with measurable goals.
  • Producing an event or renovation plan with a milestone table and risk register.
  • Revising an earlier proposal by comparing versions and listing changes under decisions required.

Frequently asked questions

Is the Proposal Writer skill free?

The source does not state a price or licence terms for the skill beyond its Apache-2.0 licence listing. Check the licence file in the repository for the terms that apply to you.

How do I install the proposal-writer agent skill?

Download the ZIP, unzip it into ~/.claude/skills/ for all projects or into a project's .claude/skills/ folder, or upload it in the Claude apps under Settings → Capabilities → Skills.

What does the skill need to run?

It needs a Word document tool available to the agent. The source does not name a specific library or service, so confirm your environment provides one.

Does the skill run scripts or use the internet?

According to its listing, it runs no scripts and uses no network. It consists of a SKILL.md file with instructions.

Why does my proposal contain TBD and est. marks?

The skill writes TBD where you did not supply an answer and never picks numbers for you. Estimates are marked est. with their basis so you can check them.

Can I use it for legal, licence or compliance decisions?

No. It defers these to subject to local rules / company policy and draws no conclusions, so specialist review is still needed.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you need a structured first draft of an internal approval or solution proposal from rough notes, and you can supply real figures or accept TBD placeholders. Pick something else if you need a finished budget or legal, licence or compliance judgement, or if you expect the tool to produce confident numbers without data.

Download the skill