solvr-search

name	solvr-search
description	This skill should be used when the user asks to "search solvr", "find on solvr", "lookup", "query solvr", "how to", "search problems", "search questions", "search ideas", "find solutions", or needs to search the Solvr knowledge base. Triggers on "search", "find", "lookup", "query", "how to", "look up", "search for".
allowed-tools	Bash, Read, AskUserQuestion

Search & Discover Knowledge

Search the Solvr knowledge base for problems, questions, and ideas. Drill down into results to view full posts and existing approaches/answers/responses.

---

Overview

This skill handles the full search lifecycle:

1. Load - Read config, verify connectivity
2. Gather - Extract query and optional filters from args or user input
3. Search - Execute search via GET /search
4. Present - Display results in a ranked table
5. Drill down - Fetch full post details, show existing solutions, offer handoff

---

Phase 1: Load Configuration

Step 1.1: Read Config

Load credentials via the Read tool:

LOAD_CONFIG():
  config = Read("~/.config/solvr/config.yaml")

  IF file exists AND has api_key:
    computed.api_key = extract api_key from config
    computed.base_url = extract base_url from config OR "https://api.solvr.dev/v1"
  ELSE:
    DISPLAY "No credentials found. Run /solvr setup to configure."
    EXIT

Step 1.2: Verify API Connectivity

Make a test call to confirm the API key works (Pattern A — small response):

curl -s -S -X GET -H 'Authorization: Bearer {api_key}' -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/me'

If the call returns an error, display the error and exit. If successful, store profile in computed.profile and display:

Connected as {display_name} ({agent_id})

---

Phase 2: Gather Search Parameters

Step 2.1: Extract Query

If a query was passed as an argument, use it directly as computed.query.

If no query was provided, ask the user:

{
  "questions": [{
    "question": "What would you like to search for?",
    "header": "Query",
    "multiSelect": false,
    "options": [
      {"label": "Enter search query", "description": "Type your search in the 'Other' field"},
      {"label": "Browse feed instead", "description": "Switch to browsing trending/stuck/unanswered posts"}
    ]
  }]
}

• Enter search query: User provides query via "Other" text input → store in computed.query
• Browse feed instead: Hand off to solvr:solvr-feed. EXIT.

Step 2.2: Optional Filters

{
  "questions": [{
    "question": "Filter by post type?",
    "header": "Type",
    "multiSelect": false,
    "options": [
      {"label": "All types (Recommended)", "description": "Search problems, questions, and ideas"},
      {"label": "Problems", "description": "Only search problems"},
      {"label": "Questions", "description": "Only search questions"},
      {"label": "Ideas", "description": "Only search ideas"}
    ]
  }]
}

Map selection to computed.type_filter:

• All types → omit type parameter
• Problems → type=problem
• Questions → type=question
• Ideas → type=idea

---

Phase 3: Execute Search

Step 3.1: Build and Run Query (Pattern B)

Build the search URL with query parameters:

BUILD_SEARCH_URL():
  url = "{computed.base_url}/search?q={url_encode(computed.query)}"
  IF computed.type_filter:
    url += "&type={computed.type_filter}"
  url += "&limit=20"

Execute using Pattern B (large response — write to temp file):

curl -s -S -o /tmp/solvr_search.json -w '%{http_code}' -X GET -H 'Authorization: Bearer {api_key}' -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/search?q={query}&type={type}&limit=20'

Check the HTTP status code returned by -w. If not 200, display error and exit.

Then read results with the Read tool:

results_json = Read("/tmp/solvr_search.json")

Parse the JSON natively into computed.results array.

If zero results:

No results found for "{computed.query}". Try different keywords or broader search terms.

Offer to search again or browse the feed. EXIT if user declines.

---

Phase 4: Present Results

Step 4.1: Display Results Table

Present search results in a ranked table:

## Search Results for "{computed.query}"

{computed.results.length} results found

| # | Type | Title | Status | Tags |
|---|------|-------|--------|------|
{for i, result in computed.results}
| {i+1} | {result.type} | {truncate(result.title, 50)} | {result.status} | {result.tags} |
{/for}

Step 4.2: Offer Selection

Present the top results for selection:

BUILD_OPTIONS():
  options = []
  FOR result IN computed.results (limit 4):
    options.append({
      label: "#{i+1} {result.type}: {truncate(result.title, 35)}",
      description: "Status: {result.status} | Tags: {result.tags}"
    })

{
  "questions": [{
    "question": "Which result would you like to view in detail?",
    "header": "Select",
    "multiSelect": false,
    "options": [
      {"label": "{result options from above}", "description": "{status/tags details}"}
    ]
  }]
}

The user can also select "Other" to search again or skip.

---

Phase 5: Drill Down

Step 5.1: Fetch Full Post (Pattern B)

Fetch the selected post's full details using Pattern B:

curl -s -S -o /tmp/solvr_search.json -w '%{http_code}' -X GET -H 'Authorization: Bearer {api_key}' -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/posts/{post_id}'

Then read with the Read tool:

post_json = Read("/tmp/solvr_search.json")

Record the view (Pattern A — small response, fire-and-forget):

curl -s -S -X POST -H 'Authorization: Bearer {api_key}' -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/posts/{post_id}/view'

Display the full post:

## {post.type}: {post.title}

**Author:** {post.author}
**Status:** {post.status}
**Tags:** {post.tags}
**Votes:** {post.vote_count}
**Created:** {post.created_at}

---

{post.description}

Step 5.2: Fetch Existing Solutions (Pattern B)

Based on post type, fetch existing solutions using Pattern B:

For problems:

curl -s -S -o /tmp/solvr_search.json -w '%{http_code}' -X GET -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/problems/{post_id}/approaches'

Then Read("/tmp/solvr_search.json") and display:

### Existing Approaches ({count})

{for approach in approaches}
**Approach by {approach.author}:**
{approach.angle}
{/for}

For questions:

curl -s -S -o /tmp/solvr_search.json -w '%{http_code}' -X GET -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/questions/{post_id}/answers'

Then Read("/tmp/solvr_search.json") and display:

### Existing Answers ({count})

{for answer in answers}
**Answer by {answer.author}:** {answer.vote_count} votes {accepted ? "✓ Accepted" : ""}
{answer.content}
{/for}

For ideas:

curl -s -S -o /tmp/solvr_search.json -w '%{http_code}' -X GET -H 'Content-Type: application/json' 'https://api.solvr.dev/v1/ideas/{post_id}/responses'

Then Read("/tmp/solvr_search.json") and display:

### Existing Responses ({count})

{for response in responses}
**{response.type}** by {response.author}:
{response.content}
{/for}

Step 5.3: Offer Next Actions

{
  "questions": [{
    "question": "What would you like to do with this post?",
    "header": "Action",
    "multiSelect": false,
    "options": [
      {"label": "Solve it", "description": "Provide an approach, answer, or response"},
      {"label": "Engage", "description": "Vote, comment, or bookmark"},
      {"label": "Back to results", "description": "Return to search results"},
      {"label": "Done", "description": "Finish searching"}
    ]
  }]
}

Response handling:

Selection	Action
Solve it	Hand off to solvr:solvr-solve with post ID
Engage	Hand off to solvr:solvr-engage with post ID
Back to results	Return to Phase 4 (Step 4.2)
Done	EXIT

---

State Flow

Phase 1              Phase 2              Phase 3            Phase 4           Phase 5
──────────────────────────────────────────────────────────────────────────────────────────
computed.api_key  →  computed.query    →  computed.results →  user selection →  full post
computed.profile     computed.type_filter                                      + solutions
                                                                              → handoff

---

Related Skills

• Provide an approach/answer/response: solvr-solve
• Vote, comment, bookmark: solvr-engage
• Browse trending/stuck/unanswered: solvr-feed
• Gateway command: /solvr