self-improve-with-tinyfish

Self-Improve With TinyFish

When To Use

Use this skill when the user asks Hermes to:

• Learn a new tool, API, framework, workflow, or domain for future tasks.
• Create, install, or improve a reusable Hermes skill.
• Research official docs and examples before writing procedural memory.
• "Teach yourself," "upgrade yourself," or "make a skill for this."

Do not use this skill for ordinary one-off answers unless the user explicitly wants a saved skill.

Pre-flight Check (REQUIRED)

Before making any TinyFish call, determine which mode to use.

1. Check for CLI:

which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_FOUND"

2. If CLI is found, check auth:

tinyfish auth status

If authenticated, use CLI mode for all searches and fetches below.

3. If CLI is not found, check for API key:

test -n "$TINYFISH_API_KEY" && echo "API_KEY_AVAILABLE" || echo "TINYFISH_API_KEY is not set"

If the API key is available, use API mode for all searches and fetches below.

4. If neither CLI nor API key is available, stop and tell the user:

Install the TinyFish CLI: npm install -g @tiny-fish/cli Then authenticate: tinyfish auth login

Or set TINYFISH_API_KEY in your environment. Get a key at: https://agent.tinyfish.ai/api-keys

Do NOT proceed until one mode is confirmed.

---

Core Workflow

1. Acknowledge the learning request.

   • Send a short progress update: I'll research this with TinyFish and create a reusable skill.
   • Extract a clean skill topic from the user request.
   • Preserve constraints such as "check official docs," "cover all endpoints," "focus on errors," or "make it production-ready."

2. Search with TinyFish.

   • Use the CLI or API (whichever passed pre-flight).
   • Run multiple targeted searches.
   • Prefer official docs and authoritative examples first.
   • Do not invent URLs.

3. Analyze search results.

   • Review titles, snippets, URLs, site names, and ranks.
   • Decide if the current sources cover setup, main workflow, edge cases, and validation.
   • If coverage is weak, run follow-up searches before fetching.