skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
gety-ai/gety-skills54 installs

gety-cli

Search and retrieve local documents via Gety CLI. Use when the user needs information from their local files, documents, or knowledge base.

How do I install this agent skill?

npx skills add https://github.com/gety-ai/gety-skills --skill gety-cli
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubwarn

    The skill enables searching and reading local documents using the Gety CLI. It also supports installing and updating executable connectors from GitHub and NPM. While the skill mandates a workflow involving a preview and user consent for installations, the capability to execute code from arbitrary remote sources and the processing of untrusted local files introduce security risks.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Usage

/gety-cli <natural language query>

Examples

/gety-cli What docx files have I updated in the last 24 hours?
/gety-cli Find meeting notes about the Q1 roadmap
/gety-cli Search for PDF documents related to security review in my Work folder
/gety-cli What's in my notes about the design system?
/gety-cli Show me the latest documents I've worked on
/gety-cli What data sources do I have connected?
/gety-cli Add ~/Documents/projects as a data source

Workflow

- [ ] Step 1: Verify gety and discover data sources ⛔ BLOCKING
- [ ] Step 2: Translate query to gety command(s)
- [ ] Step 3: Execute and iterate
- [ ] Step 4: Read specific documents (conditional)
- [ ] Step 5: Synthesize findings ⚠️ REQUIRED

Step 1: Verify gety and discover data sources ⛔ BLOCKING

Run gety connector list (or gety connector list --kind all to see both folders and custom connectors).

  • Has output → proceed. Keep the returned connector names for use as -c filter values in later steps.
  • Command not found → tell user to install Gety CLI from the Gety desktop app settings. Do NOT attempt any gety commands.
  • No connectors → tell user to add data sources first (via gety connector add <path> for folders or gety connector install <dir> for custom connectors).

Step 2: Translate query to gety command(s)

Parse the user's natural language query and map it to gety CLI flags:

User intentMaps to
File type ("docx files", "PDFs")-e <ext>
Data source ("from Work folder", "in my notes")-c "<connector_name>"
Time range ("last 24 hours", "this week")--update-time-from / --update-time-to (ISO 8601)
Recency ("recent", "latest")--sort-by update_time --sort-order descending
Topic or keyword<query> string
Title search ("named X", "titled X")--match-scope title
List data sources→ gety connector list (--kind fs / --kind custom / --kind all)
Inspect connector details→ gety connector show <id>
Add folder data source→ gety connector add <path> [--name <name>]
Install custom connector→ gety connector install <directory> --dry-run (or --github <owner/repo> / --npm <package>), show the permission summary to the user, then replace --dry-run with --yes, keeping the source and config arguments, once the user approves
Configure connector→ gety connector configure <id> [options]
Restart connector→ gety connector restart <id>
Sync / poll connector→ gety connector poll <id>
Rebuild connector index from scratch→ gety connector rebuild <id> ⚠️ deletes the connector's documents; confirm with user first
Check custom connectors for updates→ gety connector outdated (npm-installed connectors only)
Update or switch a custom connector's version→ gety connector update <id> --dry-run [--version <version>], show the preview to the user, then replace --dry-run with --yes once the user approves ⚠️ a downgrade, or a release that changed its sync format or indexed fields, deletes the connector's documents and syncs again
Enable / disable connector→ gety connector enable <id> / gety connector disable <id>
Remove data source→ gety connector remove <id> ⚠️ confirm with user first

Time calculations: When the query mentions relative time ("last 24 hours", "this week"), compute the ISO 8601 timestamp from the current date/time.

Translation examples

QueryCommand
"What docx files have I updated in the last 24 hours?"gety search "" -e docx --sort-by update_time --sort-order descending --update-time-from <24h ago>
"Find meeting notes about Q1 roadmap"gety search "Q1 roadmap meeting notes"
"PDFs about security in my Work folder"gety search "security" -c "Folder: Work" -e pdf
"What data sources do I have?"gety connector list --kind all
"Check custom connector status"gety connector show <connector_id>

Step 3: Execute and iterate

Run the translated command. If results aren't satisfactory:

  • Too many irrelevant results → add filters (-c, -e, --match-scope)
  • Too few results → broaden query, try synonyms, remove filters
  • Need more results → paginate with --offset
  • Need structured data for further processing → add --json and pipe to jq

Step 4: Read specific documents (conditional)

When document content is needed:

gety doc <connector_id> <doc_id>
  • Extract connector_id and doc_id from search results
  • Only read documents that add information you don't already have
  • For large result sets, read the top 3-5 most relevant first

⚠️ Handling large documents (Context Window Protection)

gety doc outputs full document content. Large files (lengthy PDFs, books, logs, large data dumps) can produce massive outputs that saturate context and waste tokens.

Best practices for large files:

  1. Save to a temporary file, then search with tools (Recommended): Redirect output to a file and use grep, rg, or head to inspect relevant sections:
    gety doc <connector_id> <doc_id> > /tmp/gety_doc.txt
    grep -i -C 3 "keyword" /tmp/gety_doc.txt
    head -n 50 /tmp/gety_doc.txt
    
  2. Use page ranges for paged documents: If the document has pages (e.g. PDF), limit with --page-start and --page-end:
    gety doc <connector_id> <doc_id> --page-start 1 --page-end 5
    
  3. Avoid reading if snippets suffice: If search results from gety search already provide enough context, do not fetch the full document.

Step 5: Synthesize findings ⚠️ REQUIRED

  • Combine information from multiple documents into a coherent answer
  • Cite source documents (name or path) so the user knows where info came from
  • If no relevant results found, say so clearly and suggest alternative search terms
  • NEVER paste raw gety output — always synthesize into natural language

Anti-Patterns

  • ❌ Dumping raw gety output without synthesis
  • ❌ Dumping full content of large documents into conversation context — save to a file and search with grep or paginate with --page-start/--page-end
  • ❌ Reading every document from search results — only read what's needed
  • ❌ Single search attempt then giving up — try alternative queries and filters
  • ❌ Using commands outside the CLI surface (search, doc, connector only)
  • ❌ Asking the user to run gety commands manually — run them directly

Reference

Load references/cli-capabilities.md for full CLI options, flags, and examples.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/gety-ai/gety-skills/gety-cli">View gety-cli on skillZs</a>