vp-proposal
- Repo stars 13
- Author updated Live
- Author repo viepilot
- Domain
- Documentation
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 92 / 100 · audit passed
- Author / version / license
- @0-CODE · v0.1.0 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Node.js
- Permissions
-
- Read-only
- Write / modify
- Shell exec
- Env read
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: vp-proposal
description: Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct…
category: documentation
runtime: Node.js
---
# vp-proposal output preview
## PART A: Task fit
- Use case: Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct briefs Output this banner as the first thing on every invocation — before questions, work, or any other output: runs entirely locally; runs on Node.js. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Invocation Banner / Version Update Check (ENH-072) / Persona Context Injection (ENH-073)” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct briefs Output this banner as the first thing on every invocation — before questions, work, or any other output: runs entirely locally; runs on Node.js. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “Invocation Banner / Version Update Check (ENH-072) / Persona Context Injection (ENH-073)” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, run shell commands, read environment variables; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files, run shell commands, read environment variables; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/vp-proposal`, `/multitask`, `/vp-brainstorm`, `/vp-request`, `/vp-evolve`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, run shell commands, read environment variables.
Start with a small task and check whether the result follows “Invocation Banner / Version Update Check (ENH-072) / Persona Context Injection (ENH-073)”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: vp-proposal
description: Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct…
category: documentation
source: 0-CODE/viepilot
---
# vp-proposal
## When to use
- Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct briefs Output this ba…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Invocation Banner / Version Update Check (ENH-072) / Persona Context Injection (ENH-073)” and keep inference separate from source facts.
- read files, write/modify files, run shell commands, read environment variables; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "vp-proposal" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Invocation Banner / Version Update Check (ENH-072) / Persona Context Injection (ENH-073)
rules -> SKILL.md triggers / order / output contract
runtime -> Node.js | read files, write/modify files, run shell commands, read environment variables | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Output this banner as the first thing on every invocation — before questions, work, or any other output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VIEPILOT ► VP-PROPOSAL v0.1.0 (fw 2.19.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
After displaying the greeting banner, run:
node "$HOME/.claude/viepilot/bin/vp-tools.cjs" check-update --silent
If exit code = 1 (update available — new version printed to stdout): Display notice banner before any other output:
┌──────────────────────────────────────────────────────────────────┐
│ ✨ ViePilot {latest_version} available (installed: {current}) │
│ npm i -g viepilot && vp-tools install --target {adapter_id} │
└──────────────────────────────────────────────────────────────────┘
Replace {latest_version} with stdout from the command, {current} with the installed
version, {adapter_id} with the active adapter (claude-code / cursor / antigravity / codex / copilot).
If exit code = 0 or command unavailable: silent, continue.
Suppression rules:
--no-update-checkflag on skill invocation → skip this step entirelyconfig.json→update.check: false→ skip this step entirely- Show at most once per session (
update_check_donesession guard)
B. User Prompting
Prompt user conversationally with numbered list options.
C. Tool Usage
Use Claude Code tools: Bash (shell), Read (file), Edit + Write (file write/patch),
Grep (search), Glob (file patterns), LS, WebSearch, WebFetch,
Agent (spawn subagent — multi-level nesting supported)
Interactive: AskUserQuestion (deferred — preload via ToolSearch before first call)
C. Tool Usage
Use Cursor tools: run_terminal_cmd (shell), read_file (read), edit_file (write/edit),
grep_search (search), web_search, codebase_search, list_dir, file_search
Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
Subagent: /multitask (user command, single-level only — not a callable tool)
MCP limit: 40 tools
C. Tool Usage
Use Antigravity tools: shell (cmd), file_read, file_write, MCP plugins
Interactive: text fallback (TUI-based; no formal AskUserQuestion)
Skill path: .agents/skills/<skill>/SKILL.md (project) or ~/.gemini/antigravity/skills/ (global)
Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
C. Tool Usage
Use Codex tools: container.exec (sandboxed shell), apply_patch (file write), web_search
Interactive: text fallback (TUI Tab/Enter injection)
Config: ~/.codex/config.toml
C. Tool Usage
Use Copilot tools: runCommands (shell), read/readfile (read), edit/editFiles (write),
code_search, find_references
Interactive: askQuestions (main agent only — NOT available in subagents; VS Code issue #293745)
Skill path: .github/agents/<name>.agent.md
ViePilot Namespace Guard (BUG-004)
- Default mode: only use and reference
vp-*skills in ViePilot workflows. - External skills (
non vp-*) are out of framework scope unless user explicitly opts in.
/vp-proposalgenerates output artifacts (docs/proposals/*.pptx,*.docx,*.md) — it does not implement shipping code forlib/,tests/,bin/, or frameworkworkflows//skills/.- This skill is the delivery lane after
/vp-brainstormcaptures the ideas. Use/vp-request→/vp-evolve→/vp-autofor ViePilot framework feature work. - Exception: User explicit bypass — state clearly in chat.
Output files (written to docs/proposals/):
{slug}-{date}.md— structured proposal Markdown (source of truth){slug}-{date}.pptx— presentation file (ViePilot branded, dark navy/charcoal){slug}-{date}.docx— detailed project document{slug}-{date}-slides.txt— Google Slides URL (only with--slidesflag)
Proposal types:
| Type | Slides | Use case |
|---|---|---|
project-proposal |
10 | Scope, timeline, budget for clients |
tech-architecture |
12 | Technical design for partners |
product-pitch |
12 | Investor / partner pitch deck |
general |
8 | Generic, fallback |
Template resolution (2-tier):
.viepilot/proposal-templates/{type}.pptx— project-level override{viepilot-install}/templates/proposal/pptx/{type}.pptx— ViePilot stock
Context detection:
- Auto-loads latest
docs/brainstorm/session-*.mdwhen present - Standalone mode if no session found (user provides brief)
--from session-YYYY-MM-DD.mdfor explicit session selection
` : Language for generated content — ISO 639-1 (e.g. vi, en, ja, fr, zh).
If omitted: prompted with MRU suggestions from config.
Saved to ~/.viepilot/config.json → proposal.recentLangs after generation.
- `--lang-content-only` : Translate content (bullets, notes, paragraphs) only.
Keep structural labels / section names in English.
- `--slides` : After .pptx is generated, upload to Google Slides via service account auth
Requires: `@googleapis/slides` installed + `GOOGLE_APPLICATION_CREDENTIALS` env var
- `--dry-run` : Show slide manifest (JSON) without writing any files
Step 1: Context Detection
- Scan
docs/brainstorm/forsession-*.md→ sort descending → load latest - If
--fromspecified: load that file directly - If no session found: prompt user for brief:
- Project name
- One-line description
- Target audience (client / partner / investor)
- 3–5 key points to cover
Step 2: Proposal Type Selection
- If
--typeprovided: validate; show type + slide count to confirm - Else: present menu:
1. Project Proposal (10 slides) — scope, timeline, budget 2. Tech Architecture (12 slides) — system design for partners 3. Product Pitch Deck (12 slides) — investor / partner pitch 4. General Proposal ( 8 slides) — generic fallback
Step 3: AI Slide Manifest Generation
- Structure context into JSON manifest:
{ "title": "...", "subtitle": "...", "slides": [ { "index": 1, "layout": "cover", "heading": "...", "body": "...", "speakerNotes": "..." }, { "index": 2, "layout": "section", "heading": "...", "bullets": ["..."], "speakerNotes": "..." } ] } - Slide count MUST match
PROPOSAL_TYPES[typeId].slides - If
--dry-run: print manifest and stop
Step 4: Template Resolution
- Call
resolveTemplate(typeId, 'pptx', projectRoot)→ pptx template path - Call
resolveTemplate('project-detail', 'docx', projectRoot)→ docx template path - Warn (not error) if stock fallback is used
Step 5: Generate .pptx
- Load template via pptxgenjs
- Apply slide manifest: inject titles, bullets, speaker notes per slide
- Ensure
docs/proposals/directory exists - Write
{slug}-{date}.pptx
Step 6: Generate .docx
- Build detailed document from same manifest + extended content
- Sections: Executive Summary, Problem & Solution, Features & Specifications, Technical Architecture (if relevant), Timeline, Team, Appendix
- Write
{slug}-{date}.docx
Step 7: Generate .md summary
- Write Markdown mirror of the manifest
- Save
{slug}-{date}.md
Step 8: Optional Google Slides upload (--slides)
- Call
lib/google-slides-exporter.cjs→uploadToSlides(pptxPath, title) - Write URL to
{slug}-{date}-slides.txt - On failure: surface error but do NOT fail the whole command (files already written)
Step 9: Confirm output
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VIEPILOT ► PROPOSAL GENERATED ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Type: {type label} ({N} slides)
Context: {session file or "direct brief"}
Files:
docs/proposals/{slug}-{date}.md
docs/proposals/{slug}-{date}.pptx
docs/proposals/{slug}-{date}.docx
[docs/proposals/{slug}-{date}-slides.txt] ← if --slides
Next:
Open .pptx in PowerPoint / Keynote / LibreOffice
Share .docx as supporting document
Run /vp-proposal --slides to upload to Google Slides
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Decide Fit First
Design Intent
How To Use It
Boundaries And Review