{"id":"ee3fdbc5-3cd8-4f8e-9c81-b50508dd89d2","shortId":"NuuLBs","kind":"skill","title":"idx-md","tagline":"AgentSkill for https://idx.md. Use the index to locate AI agent library topics and fetch HEAD/BODY markdown.","description":"# idx.md\n\n## Purpose\n- Markdown registry for AI agent libraries and resources.\n- Agents can browse to learn everything they could use, then fetch the exact markdown.\n\n## Index locations\n- All topics (full listing, alphabetical): https://idx.md/data/index.md (canonical) or https://idx.md/index.md (alias)\n- Capability navigation (browse by what the agent can do): https://idx.md/category/index.md\n- Scenario navigation (browse by workflow / use-case): https://idx.md/scenario/index.md\n- Industry navigation (browse by domain / vertical): https://idx.md/industry/index.md\n\n## How to choose a navigation mode\n- If you know what you want: start from `/data/index.md` and search by keywords in titles/tags.\n- If you want tools by capability: start from `/category/index.md`.\n- If you have a specific workflow/use-case: start from `/scenario/index.md`.\n- If you're operating in a specific domain: start from `/industry/index.md`.\n\n## Index entry format\n- Each entry is a HEAD frontmatter block followed by a topic line.\n- Topic line format: `|/data/{topic}|`\n- The index may start with a short HTML comment preamble; entries begin at the first `---` frontmatter block.\n\n---\n...frontmatter...\n---\n|/data/openclaw|\n\n## How to fetch\n- Read `https://idx.md/data/index.md` (or `https://idx.md/index.md`).\n- Choose `{topic}` from the `|/data/{topic}|` line.\n- HEAD metadata: `https://idx.md/{topic}` (or `/data/{topic}/HEAD.md`)\n- Vector shard (for embedding recall): `https://idx.md/{topic}/vectors.json`\n- BODY content: `https://idx.md/{topic}/BODY.md`\n- After download, compute SHA-256 on the raw BODY bytes and compare to `content_sha256` in HEAD frontmatter.\n- Use `retrieved_at` to decide whether a cached BODY needs refresh.\n\n## Vector-based retrieval (recommended)\n- Use `/{topic}/vectors.json` as the retrieval layer, then fetch `/{topic}/BODY.md` only for top candidates.\n- Each `vectors.json` currently contains one `head` record derived from HEAD metadata.\n- Build/query embeddings on `records[].text`.\n- Use `records[].metadata.content_sha256` as your embedding cache key; only re-embed when it changes.\n- Suggested flow:\n1. Collect topic candidates from `/data/index.md` or category/scenario/industry indexes.\n2. Fetch each candidate's `/{topic}/vectors.json`.\n3. Rank by vector similarity (optionally hybrid with lexical/tag score).\n4. Fetch `/{topic}/BODY.md` for top-k and generate final answer from BODY.\n\n## URL map\n- `/`, `/skill.md`, `/SKILL.md` -> this document\n- `/index.md`, `/data/index.md` -> index listing\n- `/category/index.md` -> category index listing\n- `/category/{category}/index.md` -> category topic listing\n- `/scenario/index.md` -> scenario index listing\n- `/scenario/{scenario}/index.md` -> scenario topic listing\n- `/industry/index.md` -> industry index listing\n- `/industry/{industry}/index.md` -> industry topic listing\n- `/{topic}` -> `/data/{topic}/HEAD.md`\n- `/{topic}/HEAD.md` -> HEAD metadata\n- `/{topic}/vectors.json` -> vector shard for embedding recall\n- `/{topic}/BODY.md` -> BODY content\n\n## Constraints\n- `.md` only; `.mdx` rejected by filename.\n\n## Integrity / Hash\n- `content_sha256` lives in the HEAD frontmatter.\n- `content_sha256` is the SHA-256 of the exact BODY bytes (no normalization).\n- Format: lowercase hex string.\n- Verify by hashing the downloaded BODY.md bytes and comparing to `content_sha256`.\n- If the hash differs, re-download BODY.md.\n\n## Example flow\n- Read `/index.md` -> pick `openclaw` -> fetch `/openclaw/HEAD.md` -> fetch `/openclaw/BODY.md`.\n\n## Contribute\nIf you find a high-quality markdown resource that agents should know about, please open a PR to add it.\nRepo: https://github.com/Keith-CY/idx.md\n\n### What to add\n- Add new sources to `sources/general.yml`.\n- Use a direct markdown URL (`.md`) and prefer `raw.githubusercontent.com` for GitHub content.\n- `.mdx` files are rejected.\n- Choose a `type` and `slug` that match `^[a-z0-9][a-z0-9-]*$`.\n- Avoid editing auto-generated registries (`sources/openclaw.yml`, `sources/openai.yml`, etc.) or `data/` outputs directly.\n\n### Minimal entry example\n```yaml\n- type: skills\n  slug: acme-awesome-skill\n  source_url: https://raw.githubusercontent.com/acme/awesome-skill/main/SKILL.md\n  title: Awesome Skill (optional)\n  summary: One-line summary (optional)\n  tags:\n    - skills\n  license: MIT (optional)\n  upstream_ref: https://github.com/acme/awesome-skill/blob/main/SKILL.md (optional)\n```\n\n### How to submit\n1. Fork the repo: https://github.com/Keith-CY/idx.md\n2. Add your entry to `sources/general.yml`.\n3. Open a PR with a short note on why the source is valuable for agents.\n4. If you can run the build, include generated `data/` updates; otherwise the maintainer will handle it.\n\nThanks for helping keep idx.md useful and current.","tags":["idx","keith-cy","agent-skills","ai-agents","cloudflare","index","indexing","markdown","moltbot","openclaw","registry","worker"],"capabilities":["skill","source-keith-cy","skill-idx.md","topic-agent-skills","topic-ai-agents","topic-cloudflare","topic-index","topic-indexing","topic-markdown","topic-moltbot","topic-openclaw","topic-registry","topic-worker"],"categories":["idx.md"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Keith-CY/idx.md","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add Keith-CY/idx.md","source_repo":"https://github.com/Keith-CY/idx.md","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (4,753 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:44.104Z","embedding":null,"createdAt":"2026-05-18T13:22:26.052Z","updatedAt":"2026-05-18T19:14:44.104Z","lastSeenAt":"2026-05-18T19:14:44.104Z","tsv":"'-256':224,423 '/acme/awesome-skill/blob/main/skill.md':578 '/acme/awesome-skill/main/skill.md':558 '/body.md':219,264,332,399 '/category':357 '/category/index.md':71,121,353 '/data':160,196,204,384 '/data/index.md':53,106,187,308,350 '/data/openclaw':180 '/head.md':206,386,388 '/index.md':58,191,349,359,369,379,458 '/industry':377 '/industry/index.md':91,141,373 '/keith-cy/idx.md':490,589 '/openclaw/body.md':464 '/openclaw/head.md':462 '/scenario':367 '/scenario/index.md':82,130,363 '/skill.md':345,346 '/vectors.json':214,256,318,392 '1':303,583 '2':312,590 '3':319,596 '4':329,612 '9':525,529 'a-z0':522,526 'acm':551 'acme-awesome-skil':550 'add':485,493,494,591 'agent':13,26,30,66,476,611 'agentskil':4 'ai':12,25 'alia':59 'alphabet':50 'answer':340 'auto':533 'auto-gener':532 'avoid':530 'awesom':552,560 'base':251 'begin':173 'block':151,178 'bodi':215,228,246,342,400,427 'body.md':440,454 'brows':32,62,74,85 'build':618 'build/query':280 'byte':229,428,441 'cach':245,292 'candid':268,306,315 'canon':54 'capabl':60,118 'case':79 'categori':354,358,360 'category/scenario/industry':310 'chang':300 'choos':94,192,515 'collect':304 'comment':170 'compar':231,443 'comput':222 'constraint':402 'contain':272 'content':216,233,401,411,418,445,510 'contribut':465 'could':37 'current':271,636 'data':540,621 'decid':242 'deriv':276 'differ':450 'direct':501,542 'document':348 'domain':87,138 'download':221,439,453 'edit':531 'emb':297 'embed':210,281,291,396 'entri':143,146,172,544,593 'etc':538 'everyth':35 'exact':42,426 'exampl':455,545 'fetch':17,40,183,262,313,330,461,463 'file':512 'filenam':408 'final':339 'find':468 'first':176 'flow':302,456 'follow':152 'fork':584 'format':144,159,431 'frontmatt':150,177,179,237,417 'full':48 'generat':338,534,620 'github':509 'github.com':489,577,588 'github.com/acme/awesome-skill/blob/main/skill.md':576 'github.com/keith-cy/idx.md':488,587 'handl':627 'hash':410,437,449 'head':149,199,236,274,278,389,416 'head/body':18 'help':631 'hex':433 'high':471 'high-qual':470 'html':169 'hybrid':325 'idx':2 'idx-md':1 'idx.md':6,20,52,57,70,81,90,186,190,201,212,217,633 'idx.md/category/index.md':69 'idx.md/data/index.md':51,185 'idx.md/index.md':56,189 'idx.md/industry/index.md':89 'idx.md/scenario/index.md':80 'includ':619 'index':9,44,142,163,311,351,355,365,375 'industri':83,374,378,380 'integr':409 'k':336 'keep':632 'key':293 'keyword':110 'know':100,478 'layer':260 'learn':34 'lexical/tag':327 'librari':14,27 'licens':571 'line':156,158,198,566 'list':49,352,356,362,366,372,376,382 'live':413 'locat':11,45 'lowercas':432 'maintain':625 'map':344 'markdown':19,22,43,473,502 'match':521 'may':164 'md':3,403,504 'mdx':405,511 'metadata':200,279,390 'metadata.content':287 'minim':543 'mit':572 'mode':97 'navig':61,73,84,96 'need':247 'new':495 'normal':430 'note':603 'one':273,565 'one-lin':564 'open':481,597 'openclaw':460 'oper':134 'option':324,562,568,573,579 'otherwis':623 'output':541 'pick':459 'pleas':480 'pr':483,599 'preambl':171 'prefer':506 'purpos':21 'qualiti':472 'rank':320 'raw':227 'raw.githubusercontent.com':507,557 'raw.githubusercontent.com/acme/awesome-skill/main/skill.md':556 're':133,296,452 're-download':451 're-emb':295 'read':184,457 'recal':211,397 'recommend':253 'record':275,283,286 'ref':575 'refresh':248 'registri':23,535 'reject':406,514 'repo':487,586 'resourc':29,474 'retriev':239,252,259 'run':616 'scenario':72,364,368,370 'score':328 'search':108 'sha':223,422 'sha256':234,288,412,419,446 'shard':208,394 'short':168,602 'similar':323 'skill':548,553,561,570 'skill-idx.md' 'slug':519,549 'sourc':496,554,607 'source-keith-cy' 'sources/general.yml':498,595 'sources/openai.yml':537 'sources/openclaw.yml':536 'specif':126,137 'start':104,119,128,139,165 'string':434 'submit':582 'suggest':301 'summari':563,567 'tag':569 'text':284 'thank':629 'titl':559 'titles/tags':112 'tool':116 'top':267,335 'top-k':334 'topic':15,47,155,157,161,193,197,202,205,213,218,255,263,305,317,331,361,371,381,383,385,387,391,398 'topic-agent-skills' 'topic-ai-agents' 'topic-cloudflare' 'topic-index' 'topic-indexing' 'topic-markdown' 'topic-moltbot' 'topic-openclaw' 'topic-registry' 'topic-worker' 'type':517,547 'updat':622 'upstream':574 'url':343,503,555 'use':7,38,78,238,254,285,499,634 'use-cas':77 'valuabl':609 'vector':207,250,322,393 'vector-bas':249 'vectors.json':270 'verifi':435 'vertic':88 'want':103,115 'whether':243 'workflow':76 'workflow/use-case':127 'yaml':546 'z0':524,528","prices":[{"id":"760a1699-f51b-4b89-869c-9a3dc306cb14","listingId":"ee3fdbc5-3cd8-4f8e-9c81-b50508dd89d2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"Keith-CY","category":"idx.md","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:26.052Z"}],"sources":[{"listingId":"ee3fdbc5-3cd8-4f8e-9c81-b50508dd89d2","source":"github","sourceId":"Keith-CY/idx.md","sourceUrl":"https://github.com/Keith-CY/idx.md","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:26.052Z","lastSeenAt":"2026-05-18T19:14:44.104Z"}],"details":{"listingId":"ee3fdbc5-3cd8-4f8e-9c81-b50508dd89d2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Keith-CY","slug":"idx.md","github":{"repo":"Keith-CY/idx.md","stars":6,"topics":["agent-skills","ai-agents","cloudflare","index","indexing","markdown","moltbot","openclaw","r2","registry","worker"],"license":"apache-2.0","html_url":"https://github.com/Keith-CY/idx.md","pushed_at":"2026-05-18T06:31:16Z","description":"Markdown registry for AI agent libraries with indexed HEAD/BODY content.","skill_md_sha":"e16e4df2740ec47d2fb242c06e2d96c86c995deb","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Keith-CY/idx.md"},"layout":"root","source":"github","category":"idx.md","frontmatter":{"name":"idx-md","description":"AgentSkill for https://idx.md. Use the index to locate AI agent library topics and fetch HEAD/BODY markdown."},"skills_sh_url":"https://skills.sh/Keith-CY/idx.md"},"updatedAt":"2026-05-18T19:14:44.104Z"}}