Reference Search

Use `find` when you want the shortlist without generation.

Approxination is generator-first, but approx find is still useful when you want to inspect candidate skills, compare references manually, or debug why a generated skill chose a certain path.

When To Use Find

you want to inspect candidate skills before generating
you want only a ranked shortlist of references
you want to compare alternatives manually
you are debugging a generated result and want to see the raw candidate set

CLI Example

bash

npx -y --package https://approxination.com/cli/latest/approx.tgz approx find "handle customer support email workflow"

Typical Find Response

json

{
  "skills": [
    {
      "id": "googleworkspace/cli/persona-customer-support",
      "name": "persona-customer-support",
      "source": "googleworkspace/cli",
      "rating": 1800
    },
    {
      "id": "joelhooks/joelclaw/email-triage",
      "name": "email-triage",
      "source": "joelhooks/joelclaw",
      "rating": 1499
    },
    {
      "id": "anthropics/knowledge-work-plugins/draft-response",
      "name": "draft-response",
      "source": "anthropics/knowledge-work-plugins",
      "rating": 1927
    }
  ]
}

This list is the input to generation logic. It is not the final agent workflow.

Find With Feedback Request

If the agent wants the optional feedback contract in the response, ask for it explicitly.