fondof.netlify.app

{
  "type": "object",
  "additionalProperties": false,
  "description": "Provide exactly one of need or urls/url. repo, top_shards, and private are optional. If the user provides multiple links, pass them all in urls. If the user only said something vague like 'create a skill', ask them for a need or urls before calling. Set private to false only when the user explicitly wants a public share and is signed in.",
  "properties": {
    "need": {
      "type": "string",
      "description": "A free-text description of a technique or problem to solve. Use this when the user describes a topic, not when they paste URLs. Examples: 'retry budgets for async TypeScript fetch' or 'how to cache Deno KV queries'.",
      "examples": [
        "retry budgets for async TypeScript fetch",
        "structured logging for worker services"
      ]
    },
    "url": {
      "type": "string",
      "description": "A single public article, blog post, documentation page, or YouTube URL. Prefer the urls array if the user provided multiple links.",
      "examples": [
        "https://nextjs.org/blog/next-16-3",
        "https://www.youtube.com/watch?v=7wuYBfE131U"
      ]
    },
    "urls": {
      "type": "array",
      "description": "One or more public article, blog post, documentation page, or YouTube URLs to combine into a single skill. Use this when the user gives multiple sources. Max 4 URLs.",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "examples": [
        [
          "https://www.youtube.com/watch?v=b9tB9Q1XOM0",
          "https://paulgraham.com/brandage.html"
        ]
      ]
    },
    "repo": {
      "type": "string",
      "description": "Target repository in owner/name form or as a GitHub URL.",
      "examples": [
        "udirobert/fondof"
      ]
    },
    "top_shards": {
      "type": "number",
      "description": "Number of extracted ideas to include in the skill (1-6, default 2 for single source, 3 for multi-source).",
      "minimum": 1,
      "maximum": 6,
      "examples": [
        2,
        3
      ]
    },
    "private": {
      "type": "boolean",
      "description": "When false, the skill is shared publicly and can unlock unlimited forges for signed-in users. Default is true for signed-in users (a private draft) and false for anonymous users (so the link is viewable). Only set false if a signed-in user explicitly asks to share."
    }
  }
}