idx-md
VerifiedAgentSkill for https://idx.md. Use the index to locate AI agent library topics and fetch HEAD/BODY markdown.
idx.md
Purpose
- Markdown registry for AI agent libraries and resources.
- Agents can browse to learn everything they could use, then fetch the exact markdown.
Index locations
- All topics (full listing, alphabetical): https://idx.md/data/index.md (canonical) or https://idx.md/index.md (alias)
- Capability navigation (browse by what the agent can do): https://idx.md/category/index.md
- Scenario navigation (browse by workflow / use-case): https://idx.md/scenario/index.md
- Industry navigation (browse by domain / vertical): https://idx.md/industry/index.md
How to choose a navigation mode
- If you know what you want: start from
/data/index.mdand search by keywords in titles/tags. - If you want tools by capability: start from
/category/index.md. - If you have a specific workflow/use-case: start from
/scenario/index.md. - If you're operating in a specific domain: start from
/industry/index.md.
Index entry format
- Each entry is a HEAD frontmatter block followed by a topic line.
- Topic line format:
|/data/{topic}| - The index may start with a short HTML comment preamble; entries begin at the first
---frontmatter block.
...frontmatter...
|/data/openclaw|
How to fetch
- Read
https://idx.md/data/index.md(orhttps://idx.md/index.md). - Choose
{topic}from the|/data/{topic}|line. - HEAD metadata:
https://idx.md/{topic}(or/data/{topic}/HEAD.md) - Vector shard (for embedding recall):
https://idx.md/{topic}/vectors.json - BODY content:
https://idx.md/{topic}/BODY.md - After download, compute SHA-256 on the raw BODY bytes and compare to
content_sha256in HEAD frontmatter. - Use
retrieved_atto decide whether a cached BODY needs refresh.
Vector-based retrieval (recommended)
- Use
/{topic}/vectors.jsonas the retrieval layer, then fetch/{topic}/BODY.mdonly for top candidates. - Each
vectors.jsoncurrently contains oneheadrecord derived from HEAD metadata. - Build/query embeddings on
records[].text. - Use
records[].metadata.content_sha256as your embedding cache key; only re-embed when it changes. - Suggested flow:
- Collect topic candidates from
/data/index.mdor category/scenario/industry indexes. - Fetch each candidate's
/{topic}/vectors.json. - Rank by vector similarity (optionally hybrid with lexical/tag score).
- Fetch
/{topic}/BODY.mdfor top-k and generate final answer from BODY.
URL map
/,/skill.md,/SKILL.md-> this document/index.md,/data/index.md-> index listing/category/index.md-> category index listing/category/{category}/index.md-> category topic listing/scenario/index.md-> scenario index listing/scenario/{scenario}/index.md-> scenario topic listing/industry/index.md-> industry index listing/industry/{industry}/index.md-> industry topic listing/{topic}->/data/{topic}/HEAD.md/{topic}/HEAD.md-> HEAD metadata/{topic}/vectors.json-> vector shard for embedding recall/{topic}/BODY.md-> BODY content
Constraints
.mdonly;.mdxrejected by filename.
Integrity / Hash
content_sha256lives in the HEAD frontmatter.content_sha256is the SHA-256 of the exact BODY bytes (no normalization).- Format: lowercase hex string.
- Verify by hashing the downloaded BODY.md bytes and comparing to
content_sha256. - If the hash differs, re-download BODY.md.
Example flow
- Read
/index.md-> pickopenclaw-> fetch/openclaw/HEAD.md-> fetch/openclaw/BODY.md.
Contribute
If you find a high-quality markdown resource that agents should know about, please open a PR to add it. Repo: https://github.com/Keith-CY/idx.md
What to add
- Add new sources to
sources/general.yml. - Use a direct markdown URL (
.md) and preferraw.githubusercontent.comfor GitHub content. .mdxfiles are rejected.- Choose a
typeandslugthat match^[a-z0-9][a-z0-9-]*$. - Avoid editing auto-generated registries (
sources/openclaw.yml,sources/openai.yml, etc.) ordata/outputs directly.
Minimal entry example
- type: skills
slug: acme-awesome-skill
source_url: https://raw.githubusercontent.com/acme/awesome-skill/main/SKILL.md
title: Awesome Skill (optional)
summary: One-line summary (optional)
tags:
- skills
license: MIT (optional)
upstream_ref: https://github.com/acme/awesome-skill/blob/main/SKILL.md (optional)
How to submit
- Fork the repo: https://github.com/Keith-CY/idx.md
- Add your entry to
sources/general.yml. - Open a PR with a short note on why the source is valuable for agents.
- If you can run the build, include generated
data/updates; otherwise the maintainer will handle it.
Thanks for helping keep idx.md useful and current.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |