Business Document Generator
Overview
Generate professional business documents (Project Proposals, Business Plans, Annual Budgets) from high-quality PDF templates. Use the bundled Python script to fill templates with user-provided data and output polished PDF documents ready for distribution.
When to Use This Skill
Activate this skill when the user asks to:
- Create a business proposal or project proposal
- Generate a business plan document
- Develop an annual budget plan
- Create any professional business document based on the available templates
- Fill in business templates with specific data
Available Document Types
This skill supports three types of professional business documents:
-
Project Proposal - Professional proposals for client projects
- Template:
assets/templates/Professional Proposal Template.pdf
- Use case: Pitching projects to clients, stakeholders
-
Business Plan - Comprehensive business planning documents
- Template:
assets/templates/Comprehensive Business Plan Template.pdf
- Use case: Startup planning, investor presentations, strategic planning
-
Annual Budget - Detailed budget planning documents
- Template:
assets/templates/Annual Budget Plan Template.pdf
- Use case: Financial planning, budget proposals, fiscal year planning
Quick Start Workflow
Step 1: Understand User Requirements
Gather information from the user about:
- Document type needed (proposal, business plan, or budget)
- Key data to include (company name, client info, dates, etc.)
- Any specific customization needs
Step 2: Prepare the Data
Create a JSON file with the document data. Reference the data schemas in references/document_schemas.md for field requirements.
Example for Proposal:
{
"title": "Digital Transformation Initiative",
"subtitle": "A Comprehensive Plan for Acme Corporation",
"client_org": "Acme Corporation",
"client_contact": "Jane Smith, CTO",
"company_name": "TechSolutions Inc.",
"contact_info": "[email protected]",
"date": "November 3, 2025"
}
Note: Check assets/examples/ for complete example JSON files:
proposal_example.jsonbusiness_plan_example.jsonbudget_example.json
Step 3: Install Dependencies (First Time Only)
The generation script requires Python packages. Install them:
pip install pypdf reportlab
Step 4: Generate the Document
Run the generation script:
python3 scripts/generate_document.py <document_type> <data_file> \
--templates-dir assets/templates \
--output-dir <output_directory>
Parameters:
<document_type>: One of proposal, business_plan, or budget<data_file>: Path to JSON file with document data--templates-dir: Directory containing PDF templates (default: assets/templates)--output-dir: Where to save generated PDFs (default: output)--output-filename: Optional custom filename
Example:
python3 scripts/generate_document.py proposal my_proposal_data.json \
--templates-dir assets/templates \
--output-dir ./generated_docs
Step 5: Deliver the Document
The script outputs a PDF file in the specified output directory. Verify the document was generated successfully and inform the user of the file location.
Detailed Usage Instructions
Creating a Project Proposal
-
Collect proposal information:
- Project title and subtitle
- Client organization and contact
- Your company name and contact info
- Project details (problem, solution, timeline, budget)
-
Create a JSON data file with proposal fields (see references/document_schemas.md)
-
Run the script:
python3 scripts/generate_document.py proposal proposal_data.json \
--templates-dir assets/templates
-
Output: Professional PDF proposal with cover page and content sections
Creating a Business Plan
-
Collect business plan information:
- Company name and legal structure
- Mission and vision statements
- Target market details
- Financial projections
-
Create a JSON data file with business plan fields
-
Run the script:
python3 scripts/generate_document.py business_plan plan_data.json \
--templates-dir assets/templates
-
Output: Comprehensive business plan PDF template
Creating an Annual Budget
-
Collect budget information:
- Fiscal year
- Company name
- Budget assumptions (inflation, growth targets)
- Revenue and expense forecasts
-
Create a JSON data file with budget fields
-
Run the script:
python3 scripts/generate_document.py budget budget_data.json \
--templates-dir assets/templates
-
Output: Annual budget plan PDF with tables and projections
Important Notes
Script Functionality
The scripts/generate_document.py script:
- Reads PDF templates from the assets directory
- Overlays user data on template pages (primarily cover pages)
- Generates a new PDF with filled information
- Preserves the original template structure and formatting
Current Limitations
The script currently fills in cover page information (titles, names, dates). The template body content serves as a professional framework that users can follow when creating their documents manually or through other PDF editing tools.
Extending the Script
To fill additional fields beyond the cover page, the script can be enhanced to:
- Parse form fields in PDFs
- Add text overlays on specific coordinates for each page
- Replace placeholder text programmatically
Modify scripts/generate_document.py to add more sophisticated PDF manipulation as needed.
Data Schema Reference
For detailed information about required and optional fields for each document type, consult:
references/document_schemas.md - Complete data structure documentation
Example Files
Find complete working examples in assets/examples/:
proposal_example.json - Sample project proposal databusiness_plan_example.json - Sample business plan databudget_example.json - Sample budget plan data
Use these as starting templates when creating new documents.
Troubleshooting
Import errors when running the script:
- Install required packages:
pip install pypdf reportlab
Template not found:
- Verify
--templates-dir points to assets/templates
- Check that PDF template files exist in the templates directory
Generated PDF is blank or missing data:
- Verify JSON data file is properly formatted
- Check that required fields are present (see
references/document_schemas.md)
Need to customize templates:
- Original templates are in
assets/templates/
- Modify templates using PDF editing software
- Keep original filenames or update
TEMPLATE_MAP in the script
Resources
scripts/
Contains the Python script for document generation:
generate_document.py - Main document generation script with CLI interface
This script can be executed directly without loading into context for token efficiency. It may be read if modifications or debugging are needed.
references/
Documentation to reference while working:
document_schemas.md - Complete JSON data structure for all document types
assets/
Files used in the document generation output:
templates/ - Professional PDF templates for each document type
Professional Proposal Template.pdfComprehensive Business Plan Template.pdfAnnual Budget Plan Template.pdf
examples/ - Sample JSON data files demonstrating proper structure
proposal_example.jsonbusiness_plan_example.jsonbudget_example.json
These templates and examples are not loaded into context but referenced during generation.
