Help us improve
Share bugs, ideas, or general feedback.
From common-utilities
Drafts 1-2 page executive briefing notes for infrastructure acquisitions, board approval requests, and time-sensitive authorization memos.
npx claudepluginhub reggiechan74/vp-real-estate --plugin common-utilitiesHow this skill is triggered — by the user, by Claude, or both
Slash command
/common-utilities:briefing-note-expertThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Executive briefing notes** are concise (1-2 page) decision documents that synthesize complex acquisition decisions into clear recommendations for board approval or executive authorization.
README.mdbriefing_note_generator.pybriefing_note_input_schema.jsonmodules/analysis.pymodules/output_formatters.pymodules/validators.pysamples/sample_1_transit_station_acquisition.jsonscripts/shared_utils/README_FINANCIAL_UTILS.mdscripts/shared_utils/__init__.pyscripts/shared_utils/financial_utils.pyscripts/shared_utils/land_assembly_utils.pyscripts/shared_utils/negotiation_utils.pyscripts/shared_utils/report_utils.pyscripts/shared_utils/risk_utils.pyscripts/shared_utils/schemas/comparable_sales_input_schema.jsonscripts/shared_utils/stakeholder_utils.pyscripts/shared_utils/timeline_utils.pyDrafts board approval memoranda, authorization/ratification resolutions, and governance documents with NPV analysis and risk assessment. Useful for formalizing infrastructure project decisions.
Creates consulting-grade reports and executive presentations using SCQA/SCR structure, Pyramid Principle for strategic assessments, board decks, and due diligence.
Drafts a structured investment committee memo for PE deal approval, synthesizing due diligence, financial analysis, and deal terms into a professional IC-ready document.
Share bugs, ideas, or general feedback.
Executive briefing notes are concise (1-2 page) decision documents that synthesize complex acquisition decisions into clear recommendations for board approval or executive authorization.
Use this skill when:
Do NOT use this skill for:
Purpose: Immediately communicate what decision is needed
Format:
## Issue / Decision Required
[Clear statement of decision or authorization being sought]
**Urgency:** [LOW/MEDIUM/HIGH] - [Brief urgency explanation]
Best practices:
Example:
## Issue / Decision Required
Board approval required for $1,850,000 property acquisition to secure transit station site.
**Urgency:** HIGH - Critical deadline January 31, 2026 to maintain LRT project schedule
Purpose: Provide essential context for informed decision-making
Key elements:
Format:
## Background and Context
[2-3 paragraph narrative explaining project context]
### Project Timeline
| Milestone | Date | Status |
|:----------|:----:|:------:|
| [Milestone] | [Date] | ✅/🔄/⏳ [Status] |
### Key Stakeholders
| Name | Role | Position |
|:-----|:-----|:--------:|
| [Name] | [Role] | ✅/➖/❌ [Position] |
Best practices:
Purpose: Present financial summary and evaluate alternatives
Key elements:
Format:
## Analysis
### Financial Summary
**Total Cost:** $1,850,000
**Cost Breakdown:**
- Acquisition: $1,650,000 (89.2%)
- Legal: $75,000 (4.1%)
- Expert: $50,000 (2.7%)
- Disturbance: $60,000 (3.2%)
- Other: $15,000 (0.8%)
**Contingency:** $185,000 (10.0%)
### Budget Comparison
**Approved Budget:** $1,700,000
**Total Cost:** $1,850,000
**Variance:** ⚠️ $150,000 (over budget, 8.8%)
**Funding Source:** Transit Expansion Capital Fund 2025-2026
### Strategic Alignment
[Strategic rationale paragraph]
**Key Benefits (4):**
1. [Benefit 1]
2. [Benefit 2]
3. [Benefit 3]
... and [N] more
**Supporting Precedents (2):**
- [Project]: [Outcome]
### Alternatives Considered
**[Alternative A]**
- Cost: $2,200,000 ($350,000 more, 18.9%)
- Timeline Impact: 6 month delay for tunnel construction
- Pros: Lower acquisition cost, Vacant land
- Cons: Poor pedestrian access, Additional construction costs
**[Alternative B]**
...
**Cost Comparison Summary:**
| Alternative | Cost | Cost vs Recommended | Timeline Impact |
|:------------|-----:|--------------------:|:----------------|
| [Alt] | [$] | [$] | [Impact] |
Best practices:
Purpose: Clear, actionable recommendation with rationale
Format:
## Recommendation
**[Approve/Reject/Defer] [Specific Action]**
**Rationale:** [Brief explanation connecting to analysis]
**Financial Impact:** $[Amount]
**Decision Urgency:** [LEVEL] - [Key constraint]
**Strategic Benefits:** [N] key benefits identified, [N] supporting precedent(s)
**Alternatives Considered:** [N] alternative(s) evaluated (lowest cost option would
save $[X] but [key reason for rejection])
Best practices:
Example:
## Recommendation
**Approve acquisition of 2550 Yonge Street at $1,850,000**
**Rationale:** Recommended acquisition at $1.85M is 12% above budget but represents
best value when considering alternatives. Alternative sites would result in higher
all-in costs ($2.2M for Site A with tunnel, $1.6M base for Site B plus 18-month
expropriation delay worth $500k+). Deferring acquisition risks market appreciation
($50k-100k/month) and potential holdout.
**Financial Impact:** $1,850,000
**Decision Urgency:** HIGH - Critical deadline January 31, 2026
**Strategic Benefits:** 6 key benefits identified, 2 supporting precedents
**Alternatives Considered:** 3 alternatives evaluated (lowest cost option would
save $350k base but costs $800k more all-in due to tunnel construction)
Purpose: Identify key risks and mitigation strategies
Format:
## Risk Assessment
**Overall Risk Level:** [LEVEL] (Score: [X]/100)
**Risk Summary:** [N] Critical, [N] High, [N] Medium, [N] Low
### Critical Risks
**[Risk Name]**
- Probability: [X]%
- Impact: [Impact description]
- Mitigation: [Mitigation strategy]
### High Risks
...
### Medium Risks
...
### Low Risks
...
Best practices:
Risk severity guidelines:
Purpose: Clarify authorization pathway
Format:
## Approvals Required
| Authority | Level | Threshold | Timing |
|:----------|:------|----------:|:-------|
| [Body] | [Type] | $[Amount] | [When] |
Best practices:
Purpose: Define next steps with accountability
Format:
## Action Items
### High Priority
1. **[Action]**
- Responsible: [Name/Role]
- Deadline: [Date]
### Medium Priority
...
### Low Priority
...
Best practices:
Priority guidelines:
Tool: briefing_note_generator.py
Purpose: Generate executive briefing notes from structured JSON input
Workflow: JSON input → Validation → Analysis → Markdown output
File: briefing_note_input_schema.json
Required fields:
project_name: Project identifierissue: Decision requiredbackground: Context and timelinefinancial_summary: Cost breakdownrecommendation: Primary recommendationOptional fields:
urgency: low/medium/high (default: medium)analysis: Strategic rationale, alternatives, benefits, precedentsrisks: Risk assessment with severity and mitigationaction_items: Next steps with owners and deadlinesapprovals_required: Authorization requirementsmetadata: Prepared by, department, date, classificationSample: samples/sample_1_transit_station_acquisition.json
# Basic usage
python briefing_note_generator.py samples/sample_1_transit_station_acquisition.json
# Specify output path
python briefing_note_generator.py input.json --output Reports/my_briefing_note.md
# Verbose mode (detailed analysis)
python briefing_note_generator.py input.json --verbose
Input validation includes:
Validation levels:
modules/validators.py:
validate_briefing_note_input(): Schema and required field validationvalidate_financial_consistency(): Cost breakdown and variance checksvalidate_timeline_logic(): Date sequencing and logicvalidate_risk_assessment(): Risk completeness and consistencymodules/analysis.py:
analyze_decision_urgency(): Urgency scoring based on timeline and constraintsanalyze_alternatives(): Cost comparison and key differentiatorsanalyze_strategic_alignment(): Benefits count and strategic scorecalculate_overall_risk_score(): Weighted risk scoringmodules/output_formatters.py:
format_issue_section(): Issue with urgency indicatorformat_background_section(): Context, timeline tables, stakeholder tablesformat_analysis_section(): Financial summary, alternatives comparisonformat_recommendation_section(): Recommendation with strategic contextformat_risk_section(): Risk assessment grouped by severityformat_action_items_section(): Action items grouped by prioritygenerate_briefing_note(): Complete markdown documentFormat: Markdown (.md)
File naming: YYYY-MM-DD_HHMMSS_briefing_note_[project_name].md
Location: Reports/ directory with timestamp prefix
Structure:
Length: Typically 1-2 pages (aim for under 1,500 words)
Shared_Utils/report_utils.pyUsed for:
generate_document_header(): Standard header with title, subtitle, metadataformat_financial_summary(): Financial data with currency formattingformat_risk_assessment(): Risk grouping by severitygenerate_action_items(): Action items grouped by priorityformat_markdown_table(): Table generation with alignmenteastern_timestamp(): Timestamp prefix for file namingShared_Utils/risk_utils.pyUsed for:
assess_holdout_risk(): Holdout risk scoring (if property assembly context)litigation_risk_assessment(): Litigation probability (if expropriation context)Note: These are optional - only used when briefing note involves property assembly or expropriation risk
1. Lead with decision
2. Be concise
3. Show trade-offs
4. Mitigate risks
5. Make it actionable
1. Too much detail
2. Vague recommendations
3. Hiding bad news
4. Analysis without synthesis
5. No clear action items
HIGH urgency:
MEDIUM urgency:
LOW urgency:
Always include:
Budget variance handling:
Alternatives comparison:
Complementary skills:
land-assembly-expert: Property assembly strategy for multi-parcel acquisitionssettlement-analysis-expert: Negotiation vs. expropriation decision analysistransit-station-site-acquisition-strategy: Site selection for transit projectsexpropriation-timeline-expert: Expropriation process timelinesWorkflow integration:
Sample inputs available:
samples/sample_1_transit_station_acquisition.json - Full transit station acquisition exampleUse sample as template:
Before submitting briefing note:
Content checks:
Financial checks:
Risk checks:
Action checks:
Executive-ready briefing notes must:
Target audience:
Distribution:
JSON Input (project data)
↓
Validation (schema + business rules)
↓
Analysis (urgency, alternatives, risks, strategic)
↓
Markdown Generation (formatted sections)
↓
Output (Reports/YYYY-MM-DD_HHMMSS_briefing_note_[project].md)
Advantages of automated approach:
When to use manual vs. automated: