ultimate-pi 0.1.0 → 0.1.3

package/.agents/skills/firecrawl-parse/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: firecrawl-parse
+description: |
+  Efficiently extract and convert the contents of any local file—such as PDF, DOCX, DOC, ODT, RTF, XLSX, XLS, or HTML—into clean, well-formatted markdown saved to disk. Use this skill whenever the user requests to parse, read, or extract information from a file on their computer, including phrases like “parse this PDF”, “convert this document”, “read this file”, “extract text from”, or when a local file path (not a URL) is provided. This skill offers advanced options like generating AI-powered summaries and answering questions based on the file's content. Prefer this tool over `scrape` when handling local files to deliver precise, structured outputs for downstream tasks.
+allowed-tools:
+  - Bash(firecrawl *)
+  - Bash(npx firecrawl *)
+---
+
+# firecrawl parse
+
+Turn a local document into clean markdown on disk. Supports **PDF, DOCX, DOC, ODT, RTF, XLSX, XLS, HTML/HTM/XHTML**.
+
+## When to use
+
+- You have a file on disk (not a URL) and want its text as markdown
+- User drops a PDF/DOCX and asks what it says, or to summarize it
+- Use `scrape` instead when the source is a URL
+
+## Quick start
+
+Always save to `.firecrawl/` with `-o` — parsed docs can be hundreds of KB and blow up context if streamed to stdout. Add `.firecrawl/` to `.gitignore`.
+
+```bash
+mkdir -p .firecrawl
+
+# File → markdown
+firecrawl parse ./paper.pdf -o .firecrawl/paper.md
+
+# AI summary
+firecrawl parse ./paper.pdf -S -o .firecrawl/paper-summary.md
+
+# Ask a question about the doc
+firecrawl parse ./paper.pdf -Q "What are the main conclusions?" \
+  -o .firecrawl/paper-qa.md
+```
+
+Then `head`, `grep`, `rg` etc., or incrementally read the file - don't load the whole thing at once.
+
+## Options
+
+| Option                 | Description                             |
+| ---------------------- | --------------------------------------- |
+| `-S, --summary`        | AI-generated summary                    |
+| `-Q, --query <prompt>` | Ask a question about the parsed content |
+| `-o, --output <path>`  | Output file path — **always use this**  |
+| `-f, --format <fmt>`   | `markdown` (default), `html`, `summary` |
+| `--timeout <ms>`       | Timeout for the parse job               |
+| `--timing`             | Show request duration                   |
+
+## Tips
+
+- Quote paths with spaces: `firecrawl parse "./My Doc.pdf" -o .firecrawl/mydoc.md`.
+- Max upload size: **50 MB** per file.
+- Credits: ~1 per PDF page; HTML is 1 flat.
+- Check `.firecrawl/` before re-parsing the same file.
+- To check your credit balance (recommended for batch processing and similar workflows), use the `firecrawl credit-usage` command.
+
+## See also
+
+- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — same idea for URLs

package/.agents/skills/firecrawl-scrape/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: firecrawl-scrape
+description: |
+  Extract clean markdown from any URL, including JavaScript-rendered SPAs. Use this skill whenever the user provides a URL and wants its content, says "scrape", "grab", "fetch", "pull", "get the page", "extract from this URL", or "read this webpage". Handles JS-rendered pages, multiple concurrent URLs, and returns LLM-optimized markdown. Use this instead of WebFetch for any webpage content extraction.
+allowed-tools:
+  - Bash(firecrawl *)
+  - Bash(npx firecrawl *)
+---
+
+# firecrawl scrape
+
+Scrape one or more URLs. Returns clean, LLM-optimized markdown. Multiple URLs are scraped concurrently.
+
+## When to use
+
+- You have a specific URL and want its content
+- The page is static or JS-rendered (SPA)
+- Step 2 in the [workflow escalation pattern](firecrawl-cli): search → **scrape** → map → crawl → interact
+
+## Quick start
+
+```bash
+# Basic markdown extraction
+firecrawl scrape "<url>" -o .firecrawl/page.md
+
+# Main content only, no nav/footer
+firecrawl scrape "<url>" --only-main-content -o .firecrawl/page.md
+
+# Wait for JS to render, then scrape
+firecrawl scrape "<url>" --wait-for 3000 -o .firecrawl/page.md
+
+# Multiple URLs (each saved to .firecrawl/)
+firecrawl scrape https://example.com https://example.com/blog https://example.com/docs
+
+# Get markdown and links together
+firecrawl scrape "<url>" --format markdown,links -o .firecrawl/page.json
+
+# Ask a question about the page
+firecrawl scrape "https://example.com/pricing" --query "What is the enterprise plan price?"
+```
+
+## Options
+
+| Option                   | Description                                                      |
+| ------------------------ | ---------------------------------------------------------------- |
+| `-f, --format <formats>` | Output formats: markdown, html, rawHtml, links, screenshot, json |
+| `-Q, --query <prompt>`   | Ask a question about the page content (5 credits)                |
+| `-H`                     | Include HTTP headers in output                                   |
+| `--only-main-content`    | Strip nav, footer, sidebar — main content only                   |
+| `--wait-for <ms>`        | Wait for JS rendering before scraping                            |
+| `--include-tags <tags>`  | Only include these HTML tags                                     |
+| `--exclude-tags <tags>`  | Exclude these HTML tags                                          |
+| `-o, --output <path>`    | Output file path                                                 |
+
+## Tips
+
+- **Prefer plain scrape over `--query`.** Scrape to a file, then use `grep`, `head`, or read the markdown directly — you can search and reason over the full content yourself. Use `--query` only when you want a single targeted answer without saving the page (costs 5 extra credits).
+- **Try scrape before interact.** Scrape handles static pages and JS-rendered SPAs. Only escalate to `interact` when you need interaction (clicks, form fills, pagination).
+- Multiple URLs are scraped concurrently — check `firecrawl --status` for your concurrency limit.
+- Single format outputs raw content. Multiple formats (e.g., `--format markdown,links`) output JSON.
+- Always quote URLs — shell interprets `?` and `&` as special characters.
+- Naming convention: `.firecrawl/{site}-{path}.md`
+
+## See also
+
+- [firecrawl-search](../firecrawl-search/SKILL.md) — find pages when you don't have a URL
+- [firecrawl-interact](../firecrawl-interact/SKILL.md) — when scrape can't get the content, use `interact` to click, fill forms, etc.
+- [firecrawl-download](../firecrawl-download/SKILL.md) — bulk download an entire site to local files

package/.agents/skills/firecrawl-search/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: firecrawl-search
+description: |
+  Web search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "search for", "find me", "look up", "what are people saying about", or "find articles about". Returns real search results with optional full-page markdown — not just snippets. Provides capabilities beyond Claude's built-in WebSearch.
+allowed-tools:
+  - Bash(firecrawl *)
+  - Bash(npx firecrawl *)
+---
+
+# firecrawl search
+
+Web search with optional content scraping. Returns search results as JSON, optionally with full page content.
+
+## When to use
+
+- You don't have a specific URL yet
+- You need to find pages, answer questions, or discover sources
+- First step in the [workflow escalation pattern](firecrawl-cli): search → scrape → map → crawl → interact
+
+## Quick start
+
+```bash
+# Basic search
+firecrawl search "your query" -o .firecrawl/result.json --json
+
+# Search and scrape full page content from results
+firecrawl search "your query" --scrape -o .firecrawl/scraped.json --json
+
+# News from the past day
+firecrawl search "your query" --sources news --tbs qdr:d -o .firecrawl/news.json --json
+```
+
+## Options
+
+| Option                               | Description                                   |
+| ------------------------------------ | --------------------------------------------- |
+| `--limit <n>`                        | Max number of results                         |
+| `--sources <web,images,news>`        | Source types to search                        |
+| `--categories <github,research,pdf>` | Filter by category                            |
+| `--tbs <qdr:h\|d\|w\|m\|y>`          | Time-based search filter                      |
+| `--location`                         | Location for search results                   |
+| `--country <code>`                   | Country code for search                       |
+| `--scrape`                           | Also scrape full page content for each result |
+| `--scrape-formats`                   | Formats when scraping (default: markdown)     |
+| `-o, --output <path>`                | Output file path                              |
+| `--json`                             | Output as JSON                                |
+
+## Tips
+
+- **`--scrape` fetches full content** — don't re-scrape URLs from search results. This saves credits and avoids redundant fetches.
+- Always write results to `.firecrawl/` with `-o` to avoid context window bloat.
+- Use `jq` to extract URLs or titles: `jq -r '.data.web[].url' .firecrawl/search.json`
+- Naming convention: `.firecrawl/search-{query}.json` or `.firecrawl/search-{query}-scraped.json`
+
+## See also
+
+- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape a specific URL
+- [firecrawl-map](../firecrawl-map/SKILL.md) — discover URLs within a site
+- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract from a site

package/.agents/skills/obsidian-bases/SKILL.md

@@ -0,0 +1,299 @@
+---
+name: obsidian-bases
+description: "Create and edit Obsidian Bases (.base files): Obsidian's native database layer for dynamic tables, card views, list views, filters, formulas, and summaries over vault notes. Triggers on: create a base, add a base file, obsidian bases, base view, filter notes, formula, database view, dynamic table, task tracker base, reading list base."
+allowed-tools: Read Write
+---
+
+# obsidian-bases: Obsidian's Database Layer
+
+Obsidian Bases (launched 2025) turns vault notes into queryable, dynamic views. Tables, cards, lists, maps. Defined in `.base` files. No plugin required; it is a core Obsidian feature.
+
+**Authoritative reference**: If the kepano/obsidian-skills plugin is installed, prefer its canonical obsidian-bases skill. Otherwise, use the reference below. Official docs: https://help.obsidian.md/bases/syntax
+
+---
+
+## Wiki Path Resolution
+
+All `wiki/` paths in this skill (in `.base` filter expressions like `file.inFolder("wiki/")`) are relative to the wiki directory inside the Obsidian vault. Obsidian Bases operate on the vault directly; the `wiki/` prefix in filter expressions reflects the folder name within the vault. If your wiki folder has a different name, adjust filter paths accordingly.
+
+---
+
+## File Format
+
+`.base` files contain valid YAML. The root keys are `filters`, `formulas`, `properties`, `summaries`, and `views`.
+
+```yaml
+# Global filters: apply to ALL views
+filters:
+  and:
+    - file.hasTag("wiki")
+    - 'status != "archived"'
+
+# Computed properties
+formulas:
+  age_days: '(now() - file.ctime).days.round(0)'
+  status_icon: 'if(status == "mature", "✅", "🔄")'
+
+# Display name overrides for properties panel
+properties:
+  status:
+    displayName: "Status"
+  formula.age_days:
+    displayName: "Age (days)"
+
+# One or more views
+views:
+  - type: table
+    name: "All Pages"
+    order:
+      - file.name
+      - type
+      - status
+      - updated
+      - formula.age_days
+```
+
+---
+
+## Filters
+
+Filters select which notes appear. Applied globally or per-view.
+
+```yaml
+# Single string filter
+filters: 'status == "current"'
+
+# AND: all must be true
+filters:
+  and:
+    - 'status != "archived"'
+    - file.hasTag("wiki")
+
+# OR: any can be true
+filters:
+  or:
+    - file.hasTag("concept")
+    - file.hasTag("entity")
+
+# NOT: exclude matches
+filters:
+  not:
+    - file.inFolder("wiki/meta")
+
+# Nested
+filters:
+  and:
+    - file.inFolder("wiki/")
+    - or:
+        - 'type == "concept"'
+        - 'type == "entity"'
+```
+
+### Filter operators
+
+`==` `!=` `>` `<` `>=` `<=`
+
+### Useful filter functions
+
+| Function | Example |
+|----------|---------|
+| `file.hasTag("x")` | Notes with tag `x` |
+| `file.inFolder("path/")` | Notes in folder |
+| `file.hasLink("Note")` | Notes linking to Note |
+
+---
+
+## Properties
+
+Three types:
+- **Note properties**: from frontmatter: `status`, `type`, `updated`
+- **File properties**: metadata: `file.name`, `file.mtime`, `file.size`, `file.ctime`, `file.tags`, `file.folder`
+- **Formula properties**: computed: `formula.age_days`
+
+---
+
+## Formulas
+
+Defined in `formulas:`. Referenced as `formula.name` in `order:` and `properties:`.
+
+```yaml
+formulas:
+  # Days since created
+  age_days: '(now() - file.ctime).days.round(0)'
+
+  # Days until a date property
+  days_until: 'if(due_date, (date(due_date) - today()).days, "")'
+
+  # Conditional label
+  status_icon: 'if(status == "mature", "✅", if(status == "developing", "🔄", "🌱"))'
+
+  # Word count estimate
+  word_est: '(file.size / 5).round(0)'
+```
+
+**Key rule**: Subtracting two dates returns a `Duration`. Not a number. Always access `.days` first:
+```yaml
+# CORRECT
+age: '(now() - file.ctime).days'
+
+# WRONG: crashes
+age: '(now() - file.ctime).round(0)'
+```
+
+**Always guard nullable properties with `if()`**:
+```yaml
+# CORRECT
+days_left: 'if(due_date, (date(due_date) - today()).days, "")'
+```
+
+---
+
+## View Types
+
+### Table
+```yaml
+views:
+  - type: table
+    name: "Wiki Index"
+    limit: 100
+    order:
+      - file.name
+      - type
+      - status
+      - updated
+    groupBy:
+      property: type
+      direction: ASC
+```
+
+### Cards
+```yaml
+views:
+  - type: cards
+    name: "Gallery"
+    order:
+      - file.name
+      - tags
+      - status
+```
+
+### List
+```yaml
+views:
+  - type: list
+    name: "Quick List"
+    order:
+      - file.name
+      - status
+```
+
+---
+
+## Wiki Vault Templates
+
+### Wiki content dashboard (all non-meta pages)
+
+```yaml
+filters:
+  and:
+    - file.inFolder("wiki/")
+    - not:
+        - file.inFolder("wiki/meta")
+
+formulas:
+  age: '(now() - file.ctime).days.round(0)'
+
+properties:
+  formula.age:
+    displayName: "Age (days)"
+
+views:
+  - type: table
+    name: "All Wiki Pages"
+    order:
+      - file.name
+      - type
+      - status
+      - updated
+      - formula.age
+    groupBy:
+      property: type
+      direction: ASC
+```
+
+### Entity index (people, orgs, repos)
+
+```yaml
+filters:
+  and:
+    - file.inFolder("wiki/entities/")
+    - 'file.ext == "md"'
+
+views:
+  - type: table
+    name: "Entities"
+    order:
+      - file.name
+      - entity_type
+      - status
+      - updated
+    groupBy:
+      property: entity_type
+      direction: ASC
+```
+
+### Recent ingests
+
+```yaml
+filters:
+  and:
+    - file.inFolder("wiki/sources/")
+
+views:
+  - type: table
+    name: "Sources"
+    order:
+      - file.name
+      - source_type
+      - created
+      - status
+    groupBy:
+      property: source_type
+      direction: ASC
+```
+
+---
+
+## Embedding in Notes
+
+```markdown
+![[MyBase.base]]
+
+![[MyBase.base#View Name]]
+```
+
+---
+
+## Where to Save
+
+Store `.base` files in `wiki/meta/` for vault dashboards:
+- `wiki/meta/dashboard.base`: main content view
+- `wiki/meta/entities.base`: entity tracker
+- `wiki/meta/sources.base`: ingestion log
+
+---
+
+## YAML Quoting Rules
+
+- Formulas with double quotes → wrap in single quotes: `'if(done, "Yes", "No")'`
+- Strings with colons or special chars → wrap in double quotes: `"Status: Active"`
+- Unquoted strings with `:` break YAML parsing
+
+---
+
+## What Not to Do
+
+- Do not use `from:` or `where:`: those are Dataview syntax, not Obsidian Bases
+- Do not use `sort:` at the root level: sorting is per-view via `order:` and `groupBy:`
+- Do not put `.base` files outside the vault: they only render inside Obsidian
+- Do not reference `formula.X` in `order:` without defining `X` in `formulas:`