openclaw-node-harness 2.0.0

package/skills/pdf/SKILL.md

@@ -0,0 +1,304 @@
+---
+name: pdf
+description: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.
+triggers:
+  - "extract text from this PDF"
+  - "merge these PDFs together"
+  - "fill out this PDF form"
+  - "split this PDF into pages"
+  - "create a PDF from this content"
+negative_triggers:
+  - "read this PDF file"
+  - "convert markdown to PDF"
+  - "open this document"
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# PDF Processing Guide
+
+## Overview
+
+This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see reference.md. If you need to fill out a PDF form, read forms.md and follow its instructions.
+
+## Quick Start
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Read a PDF
+reader = PdfReader("document.pdf")
+print(f"Pages: {len(reader.pages)}")
+
+# Extract text
+text = ""
+for page in reader.pages:
+    text += page.extract_text()
+```
+
+## Python Libraries
+
+### pypdf - Basic Operations
+
+#### Merge PDFs
+```python
+from pypdf import PdfWriter, PdfReader
+
+writer = PdfWriter()
+for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
+    reader = PdfReader(pdf_file)
+    for page in reader.pages:
+        writer.add_page(page)
+
+with open("merged.pdf", "wb") as output:
+    writer.write(output)
+```
+
+#### Split PDF
+```python
+reader = PdfReader("input.pdf")
+for i, page in enumerate(reader.pages):
+    writer = PdfWriter()
+    writer.add_page(page)
+    with open(f"page_{i+1}.pdf", "wb") as output:
+        writer.write(output)
+```
+
+#### Extract Metadata
+```python
+reader = PdfReader("document.pdf")
+meta = reader.metadata
+print(f"Title: {meta.title}")
+print(f"Author: {meta.author}")
+print(f"Subject: {meta.subject}")
+print(f"Creator: {meta.creator}")
+```
+
+#### Rotate Pages
+```python
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+page = reader.pages[0]
+page.rotate(90)  # Rotate 90 degrees clockwise
+writer.add_page(page)
+
+with open("rotated.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### pdfplumber - Text and Table Extraction
+
+#### Extract Text with Layout
+```python
+import pdfplumber
+
+with pdfplumber.open("document.pdf") as pdf:
+    for page in pdf.pages:
+        text = page.extract_text()
+        print(text)
+```
+
+#### Extract Tables
+```python
+with pdfplumber.open("document.pdf") as pdf:
+    for i, page in enumerate(pdf.pages):
+        tables = page.extract_tables()
+        for j, table in enumerate(tables):
+            print(f"Table {j+1} on page {i+1}:")
+            for row in table:
+                print(row)
+```
+
+#### Advanced Table Extraction
+```python
+import pandas as pd
+
+with pdfplumber.open("document.pdf") as pdf:
+    all_tables = []
+    for page in pdf.pages:
+        tables = page.extract_tables()
+        for table in tables:
+            if table:  # Check if table is not empty
+                df = pd.DataFrame(table[1:], columns=table[0])
+                all_tables.append(df)
+
+# Combine all tables
+if all_tables:
+    combined_df = pd.concat(all_tables, ignore_index=True)
+    combined_df.to_excel("extracted_tables.xlsx", index=False)
+```
+
+### reportlab - Create PDFs
+
+#### Basic PDF Creation
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.pdfgen import canvas
+
+c = canvas.Canvas("hello.pdf", pagesize=letter)
+width, height = letter
+
+# Add text
+c.drawString(100, height - 100, "Hello World!")
+c.drawString(100, height - 120, "This is a PDF created with reportlab")
+
+# Add a line
+c.line(100, height - 140, 400, height - 140)
+
+# Save
+c.save()
+```
+
+#### Create PDF with Multiple Pages
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
+from reportlab.lib.styles import getSampleStyleSheet
+
+doc = SimpleDocTemplate("report.pdf", pagesize=letter)
+styles = getSampleStyleSheet()
+story = []
+
+# Add content
+title = Paragraph("Report Title", styles['Title'])
+story.append(title)
+story.append(Spacer(1, 12))
+
+body = Paragraph("This is the body of the report. " * 20, styles['Normal'])
+story.append(body)
+story.append(PageBreak())
+
+# Page 2
+story.append(Paragraph("Page 2", styles['Heading1']))
+story.append(Paragraph("Content for page 2", styles['Normal']))
+
+# Build PDF
+doc.build(story)
+```
+
+## Command-Line Tools
+
+### pdftotext (poppler-utils)
+```bash
+# Extract text
+pdftotext input.pdf output.txt
+
+# Extract text preserving layout
+pdftotext -layout input.pdf output.txt
+
+# Extract specific pages
+pdftotext -f 1 -l 5 input.pdf output.txt  # Pages 1-5
+```
+
+### qpdf
+```bash
+# Merge PDFs
+qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf
+
+# Split pages
+qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
+qpdf input.pdf --pages . 6-10 -- pages6-10.pdf
+
+# Rotate pages
+qpdf input.pdf output.pdf --rotate=+90:1  # Rotate page 1 by 90 degrees
+
+# Remove password
+qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
+```
+
+### pdftk (if available)
+```bash
+# Merge
+pdftk file1.pdf file2.pdf cat output merged.pdf
+
+# Split
+pdftk input.pdf burst
+
+# Rotate
+pdftk input.pdf rotate 1east output rotated.pdf
+```
+
+## Common Tasks
+
+### Extract Text from Scanned PDFs
+```python
+# Requires: pip install pytesseract pdf2image
+import pytesseract
+from pdf2image import convert_from_path
+
+# Convert PDF to images
+images = convert_from_path('scanned.pdf')
+
+# OCR each page
+text = ""
+for i, image in enumerate(images):
+    text += f"Page {i+1}:\n"
+    text += pytesseract.image_to_string(image)
+    text += "\n\n"
+
+print(text)
+```
+
+### Add Watermark
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Create watermark (or load existing)
+watermark = PdfReader("watermark.pdf").pages[0]
+
+# Apply to all pages
+reader = PdfReader("document.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    page.merge_page(watermark)
+    writer.add_page(page)
+
+with open("watermarked.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### Extract Images
+```bash
+# Using pdfimages (poppler-utils)
+pdfimages -j input.pdf output_prefix
+
+# This extracts all images as output_prefix-000.jpg, output_prefix-001.jpg, etc.
+```
+
+### Password Protection
+```python
+from pypdf import PdfReader, PdfWriter
+
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    writer.add_page(page)
+
+# Add password
+writer.encrypt("userpassword", "ownerpassword")
+
+with open("encrypted.pdf", "wb") as output:
+    writer.write(output)
+```
+
+## Quick Reference
+
+| Task | Best Tool | Command/Code |
+|------|-----------|--------------|
+| Merge PDFs | pypdf | `writer.add_page(page)` |
+| Split PDFs | pypdf | One page per file |
+| Extract text | pdfplumber | `page.extract_text()` |
+| Extract tables | pdfplumber | `page.extract_tables()` |
+| Create PDFs | reportlab | Canvas or Platypus |
+| Command line merge | qpdf | `qpdf --empty --pages ...` |
+| OCR scanned PDFs | pytesseract | Convert to image first |
+| Fill PDF forms | pdf-lib or pypdf (see forms.md) | See forms.md |
+
+## Next Steps
+
+- For advanced pypdfium2 usage, see reference.md
+- For JavaScript libraries (pdf-lib), see reference.md
+- If you need to fill out a PDF form, follow the instructions in forms.md
+- For troubleshooting guides, see reference.md

package/skills/pestel-analysis/SKILL.md

@@ -0,0 +1,384 @@
+---
+name: pestel-analysis
+description: "Use this to analyze macro-environmental factors (Political, Economic, Social, Technological, Environmental, Legal) affecting your product. Identifies external opportunities, threats, and strategic risks."
+type: component
+triggers:
+  - "run a PESTEL analysis"
+  - "what external factors affect this product"
+  - "assess macro environment for market entry"
+  - "analyze political and economic risks"
+  - "do a macro-environment scan"
+negative_triggers:
+  - "analyze our competitors"
+  - "do an internal SWOT"
+  - "review our product metrics"
+---
+
+
+## Purpose
+Conduct a systematic analysis of macro-environmental factors—Political, Economic, Social, Technological, Environmental, and Legal—that could impact your product or project. Use this to identify external opportunities and threats, inform strategic planning, assess market entry risks, and make data-driven decisions about product direction in the context of broader forces beyond your control.
+
+This is not internal analysis—it's outward-facing assessment of the big-picture forces shaping your product's environment.
+
+## Key Concepts
+
+### The PESTEL Framework
+Originating from Francis Joseph Aguilar's 1967 PEST analysis, PESTEL extends the framework to six categories:
+
+1. **Political:** Government policies, stability, trade regulations, taxation
+2. **Economic:** Growth rates, inflation, exchange rates, consumer spending
+3. **Social:** Demographics, cultural trends, lifestyle changes, consumer attitudes
+4. **Technological:** Advancements, R&D, automation, digital transformation
+5. **Environmental:** Climate change, sustainability, resource scarcity, regulations
+6. **Legal:** Compliance, IP rights, employment laws, health/safety regulations
+
+### Why This Works
+- **Comprehensive:** Covers all major external forces affecting your product
+- **Proactive:** Identifies threats and opportunities before they become critical
+- **Strategic:** Informs long-term planning, not just tactical decisions
+- **Risk management:** Highlights vulnerabilities in your product strategy
+
+### Anti-Patterns (What This Is NOT)
+- **Not competitive analysis:** PESTEL looks at macro factors, not competitors
+- **Not internal analysis:** Focuses on external environment, not your company's strengths/weaknesses
+- **Not static:** Macro environment changes—reassess regularly
+
+### When to Use This
+- Entering a new market or geography
+- Strategic planning (annual roadmapping, 3-5 year planning)
+- Assessing product viability in a changing environment
+- Risk assessment for new product initiatives
+- Pitching to execs or investors (shows environmental awareness)
+
+### When NOT to Use This
+- For tactical, short-term decisions (use competitive analysis instead)
+- When external factors are stable and well-understood
+- As a substitute for customer research (PESTEL is macro, not micro)
+
+---
+
+## Application
+
+Use `template.md` for the full fill-in structure.
+
+### Step 1: Define the Scope
+
+Clarify what you're analyzing:
+
+```markdown
+## Overview
+
+- **Project/Product Name:** [e.g., "AI-Powered Invoice Automation for SMBs"]
+- **Analysis Purpose:** [e.g., "Assess viability of launching in EU market"]
+- **Analyst:** [Your name or team]
+- **Date:** [Date of analysis]
+- **Geographic Scope:** [e.g., "United States and European Union"]
+- **Time Horizon:** [e.g., "Next 12-24 months"]
+```
+
+**Quality checks:**
+- **Specific:** Not "analyze market" but "assess viability of EU launch"
+- **Time-bound:** PESTEL factors change—state your horizon
+
+---
+
+### Step 2: Analyze Political Factors
+
+Examine government and regulatory influences:
+
+```markdown
+## 1. Political Factors
+
+### Government Policies
+- [How could government policies impact the product?]
+- [Example: "EU's AI Act requires transparency in AI decision-making; our invoice automation must explain recommendations"]
+
+### Political Stability
+- [Assess stability in relevant regions]
+- [Example: "US political stability is moderate; potential for regulatory changes in financial tech under new administration"]
+
+### Trade Regulations
+- [Examine trade regulations and their effects]
+- [Example: "Brexit complicates data transfer between UK and EU; may require separate infrastructure"]
+
+### Taxation Policy
+- [Analyze taxation policies and implications]
+- [Example: "Digital services tax in EU (3% on revenue) could impact pricing strategy"]
+```
+
+**Quality checks:**
+- **Specific to your product:** Don't list generic policies—explain the impact
+- **Actionable:** Can you adjust strategy based on this insight?
+
+---
+
+### Step 3: Analyze Economic Factors
+
+Examine economic conditions:
+
+```markdown
+## 2. Economic Factors
+
+### Economic Growth
+- [Evaluate growth rates and their impact]
+- [Example: "SMB sector growing 5% annually in US; strong demand for automation tools"]
+
+### Inflation Rate
+- [Consider inflation and its effect on pricing/costs]
+- [Example: "High inflation (6%) pressures SMB budgets; price sensitivity increases"]
+
+### Exchange Rates
+- [Analyze exchange rate fluctuations]
+- [Example: "Weak Euro vs. Dollar makes US pricing less competitive in EU; may need regional pricing"]
+
+### Consumer Spending
+- [Assess consumer spending levels]
+- [Example: "SMBs cutting discretionary spending due to recession fears; emphasize ROI (time savings) in messaging"]
+```
+
+**Quality checks:**
+- **Data-driven:** Use real economic indicators (GDP growth, inflation rates, etc.)
+- **Product-specific:** How do these trends affect *your* product?
+
+---
+
+### Step 4: Analyze Social Factors
+
+Examine societal and cultural trends:
+
+```markdown
+## 3. Social Factors
+
+### Demographics
+- [Examine demographics and market influence]
+- [Example: "Aging SMB owners (Baby Boomers) less tech-savvy; younger Gen X/Millennial owners more receptive to automation"]
+
+### Cultural Trends
+- [Analyze cultural trends and demand impact]
+- [Example: "Growing 'hustle culture' among freelancers increases demand for time-saving tools"]
+
+### Lifestyle Changes
+- [Consider lifestyle changes and implications]
+- [Example: "Remote work boom increases solo entrepreneurs and freelancers; core target market expanding"]
+
+### Consumer Attitudes
+- [Assess consumer attitudes and behaviors]
+- [Example: "Increasing trust in AI for routine tasks (invoicing, scheduling); less resistance than 5 years ago"]
+```
+
+**Quality checks:**
+- **Trend-based:** Reference actual cultural shifts, not assumptions
+- **Validated:** Use survey data, research reports, or demographic studies
+
+---
+
+### Step 5: Analyze Technological Factors
+
+Examine technology landscape:
+
+```markdown
+## 4. Technological Factors
+
+### Technological Advancements
+- [Identify advancements and their impact]
+- [Example: "Large language models (LLMs) enable better invoice data extraction; competitive advantage if adopted early"]
+
+### R&D Activity
+- [Evaluate sector R&D levels]
+- [Example: "High R&D investment in fintech automation; rapid innovation cycle—need to iterate fast"]
+
+### Automation
+- [Assess automation implications]
+- [Example: "Competitors adopting AI-powered automation; table stakes for market entry—must match or exceed"]
+
+### Digital Transformation
+- [Consider digital transformation trends]
+- [Example: "SMBs adopting cloud-first tools (QuickBooks Online, Xero); need strong integrations to succeed"]
+```
+
+**Quality checks:**
+- **Competitive context:** How does the tech landscape affect your position?
+- **Actionable:** What R&D or partnerships do you need?
+
+---
+
+### Step 6: Analyze Environmental Factors
+
+Examine environmental and sustainability issues:
+
+```markdown
+## 5. Environmental Factors
+
+### Climate Change
+- [Analyze climate change implications]
+- [Example: "Minimal direct impact; however, B Corps and sustainability-focused SMBs prefer vendors with carbon-neutral operations"]
+
+### Sustainability Practices
+- [Evaluate sustainability impact]
+- [Example: "Growing demand for 'green tech'; marketing opportunity to highlight cloud efficiency vs. on-prem servers"]
+
+### Resource Scarcity
+- [Assess resource scarcity risks]
+- [Example: "Low risk; software product doesn't depend on physical resources"]
+
+### Environmental Regulations
+- [Examine environmental regulations]
+- [Example: "EU's Carbon Border Adjustment Mechanism (CBAM) doesn't affect SaaS directly"]
+```
+
+**Quality checks:**
+- **Honest assessment:** If impact is minimal, say so (don't force relevance)
+- **Market positioning:** Can environmental factors be a differentiator?
+
+---
+
+### Step 7: Analyze Legal Factors
+
+Examine legal and compliance landscape:
+
+```markdown
+## 6. Legal Factors
+
+### Compliance Requirements
+- [Identify legal/compliance requirements]
+- [Example: "GDPR compliance required for EU customers; must implement data residency, right-to-be-forgotten, consent management"]
+
+### Intellectual Property Rights
+- [Evaluate IP importance and protection]
+- [Example: "Patent landscape for AI invoice processing is crowded; focus on trade secrets over patents"]
+
+### Employment Laws
+- [Consider employment laws and implications]
+- [Example: "Remote hiring across EU requires understanding of local labor laws (Germany, France have strict employment contracts)"]
+
+### Health and Safety Regulations
+- [Assess health/safety regulations]
+- [Example: "Not applicable (software product)"]
+```
+
+**Quality checks:**
+- **Legal risk assessment:** What could block or delay your product?
+- **Compliance costs:** Budget for legal, data residency, certifications?
+
+---
+
+### Step 8: Synthesize Insights
+
+After analyzing all six factors, summarize:
+
+```markdown
+## Strategic Insights Summary
+
+### Top Opportunities:
+1. **[Opportunity 1]** - [Description and action]
+   - [Example: "Social: Remote work boom expands target market → Increase marketing to freelancers"]
+2. **[Opportunity 2]** - [Description and action]
+3. **[Opportunity 3]** - [Description and action]
+
+### Top Threats:
+1. **[Threat 1]** - [Description and mitigation]
+   - [Example: "Economic: Recession fears increase price sensitivity → Emphasize ROI in messaging, offer lower-tier pricing"]
+2. **[Threat 2]** - [Description and mitigation]
+3. **[Threat 3]** - [Description and mitigation]
+
+### Strategic Recommendations:
+1. **[Recommendation 1]** - [Action to take]
+2. **[Recommendation 2]** - [Action to take]
+3. **[Recommendation 3]** - [Action to take]
+```
+
+---
+
+### Step 9: Update Regularly
+
+- **Annual review:** Reassess PESTEL factors during strategic planning
+- **Trigger events:** Update when major external events occur (new regulations, economic shifts, etc.)
+- **Track changes:** Document how factors evolve over time
+
+---
+
+## Examples
+
+See `examples/sample.md` for a full PESTEL analysis example.
+
+Mini example excerpt:
+
+```markdown
+### 1. Political Factors
+- EU AI Act requires transparency in AI decision-making
+
+### 2. Economic Factors
+- High inflation increases SMB price sensitivity
+```
+
+## Common Pitfalls
+
+### Pitfall 1: Generic Analysis
+**Symptom:** "Political: Regulations exist. Economic: Economy affects spending."
+
+**Consequence:** No actionable insights.
+
+**Fix:** Be specific: "EU AI Act requires explainable AI → Need transparency features by Q3 2026."
+
+---
+
+### Pitfall 2: Ignoring Low-Impact Factors
+**Symptom:** Forcing relevance where none exists (e.g., "Climate change affects our SaaS product...")
+
+**Consequence:** Wastes time, dilutes focus.
+
+**Fix:** If a factor has low impact, say so. Focus effort on high-impact areas.
+
+---
+
+### Pitfall 3: No Data Sources
+**Symptom:** "Economic growth is strong" (no citation)
+
+**Consequence:** Unverifiable claims, low credibility.
+
+**Fix:** Cite sources: "SMB sector growing 5% annually (US Census Bureau, 2025)."
+
+---
+
+### Pitfall 4: Analysis Without Action
+**Symptom:** Long list of factors, no strategic recommendations
+
+**Consequence:** Insights don't inform decisions.
+
+**Fix:** Synthesize into "Top Opportunities," "Top Threats," and "Strategic Recommendations."
+
+---
+
+### Pitfall 5: One-Time Exercise
+**Symptom:** PESTEL analysis done once, never revisited
+
+**Consequence:** Stale insights as macro environment shifts.
+
+**Fix:** Review annually or when major external events occur (new regulations, economic shifts, etc.).
+
+---
+
+## References
+
+### Related Skills
+- `skills/recommendation-canvas/SKILL.md` — PESTEL factors inform risk assessment in canvas
+- `skills/positioning-statement/SKILL.md` — PESTEL insights shape competitive positioning
+- `skills/problem-statement/SKILL.md` — Social/economic factors influence customer problems
+
+### External Frameworks
+- Francis Joseph Aguilar, *Scanning the Business Environment* (1967) — Origin of PEST analysis
+- PESTEL (extension of PEST to include Environmental and Legal)
+- Michael Porter, *Competitive Strategy* (1980) — Complements PESTEL with industry-level analysis
+
+### Dean's Work
+- PESTEL Analysis Prompt Template (adapted from Aguilar's framework)
+
+### Provenance
+- Adapted from `prompts/pestel-analysis-prompt-template.md` in the `https://github.com/deanpeters/product-manager-prompts` repo.
+
+---
+
+**Skill type:** Component
+**Suggested filename:** `pestel-analysis.md`
+**Suggested placement:** `/skills/components/`
+**Dependencies:** References `skills/recommendation-canvas/SKILL.md`, `skills/positioning-statement/SKILL.md`