{"id":50344671,"url":"https://github.com/nasa-ammos/slim-framework","last_synced_at":"2026-05-29T19:02:40.963Z","repository":{"id":359692378,"uuid":"1245990992","full_name":"NASA-AMMOS/slim-framework","owner":"NASA-AMMOS","description":"A reusable framework for building an AI-native marketplace of best practices (skills, agents, MCP servers) installable into AI coding tools. De-branded fork of the SLIM marketplace website.","archived":false,"fork":false,"pushed_at":"2026-05-23T00:13:21.000Z","size":2640,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T02:25:37.472Z","etag":null,"topics":["ai","best-practices","claude","docusaurus","framework","marketplace","mcp","skills"],"latest_commit_sha":null,"homepage":"https://nasa-ammos.github.io/slim-framework/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NASA-AMMOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-21T19:05:52.000Z","updated_at":"2026-05-23T00:11:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/NASA-AMMOS/slim-framework","commit_stats":null,"previous_names":["nasa-ammos/slim-framework"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/NASA-AMMOS/slim-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fslim-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fslim-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fslim-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fslim-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NASA-AMMOS","download_url":"https://codeload.github.com/NASA-AMMOS/slim-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fslim-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33666290,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","best-practices","claude","docusaurus","framework","marketplace","mcp","skills"],"created_at":"2026-05-29T19:02:32.271Z","updated_at":"2026-05-29T19:02:40.958Z","avatar_url":"https://github.com/NASA-AMMOS.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Best Practices Marketplace Framework\n\nA reusable, de-branded framework for running an **AI-native marketplace of best\npractices** — skills, agents, and MCP servers that are discoverable on a website\nand installable directly into AI coding tools (Claude Code, and others).\n\nFork it, change a handful of config values, fill out one JSON file, and you have\nyour own marketplace.\n\n## What you get\n\n- A [Docusaurus](https://docusaurus.io/) website that browses, searches, and\n  filters a catalog of best practices.\n- A **multi-marketplace** browser: federate your own catalog with any number of\n  remote registries (the picker appears automatically when more than one is\n  configured).\n- A **registry-driven build**: you hand-author one file, `static/data/registry.json`,\n  and the Claude Code plugin manifest (`.claude-plugin/marketplace.json`) is\n  generated from it automatically.\n\n## Architecture\n\nThis repository follows a **single source of truth** philosophy:\n\n- **`static/data/registry.json`** — the hand-authored source of truth. It\n  describes the marketplace identity and every skill / agent / MCP server.\n- **`.claude-plugin/marketplace.json`** — **generated** from `registry.json` by\n  `src/conf/generate-marketplace.js`. This is what Claude Code reads when a user\n  runs `/plugin marketplace add \u003crepo\u003e`. It is committed so consumers can use it\n  without building the site.\n- **`static/marketplace/`** — the actual content of each best practice\n  (`SKILL.md`, assets, scripts). One folder per entry.\n- The Docusaurus website renders the registry into a searchable catalog.\n\n```\nregistry.json  ──(npm run prebuild)──▶  marketplace.json\n   (you edit)                              (generated, committed)\n```\n\n## Getting started\n\n```bash\nnpm ci          # install dependencies\nnpm start       # local dev server\nnpm run build   # production build (runs the generators first)\n```\n\n`npm run build` runs `prebuild`, which:\n\n1. `generate-marketplace.js` — reads `registry.json`, hydrates derived fields,\n   and writes `.claude-plugin/marketplace.json`.\n2. `generate-file-manifests.js` — indexes the `static/marketplace/` file trees.\n3. `create-marketplace-zips.js` — packages each entry as a downloadable zip.\n\n## Customize it for your project\n\n1. **`docusaurus.config.js`** — edit the values under the `CUSTOMIZE ME` banner:\n   `title`, `tagline`, `url`, `baseUrl`, `organizationName`, `projectName`, the\n   navbar/footer links, and `marketplaceConfig.registries`.\n2. **`static/data/registry.json`** — edit the top-level `marketplace` block\n   (`name`, `owner`, `metadata`) and add your entries to `skills` / `agents` /\n   `mcp`.\n3. **`static/img/`** — replace `logo.svg` and `favicon.ico` with your own.\n4. **`docs/`** — update the About / FAQ / Contribute pages.\n\n## Adding a best practice\n\n1. Create the content folder, e.g. `static/marketplace/skills/\u003cname\u003e/SKILL.md`\n   (plus any `assets/` and `scripts/`).\n2. Add an entry to the `skills` array in `static/data/registry.json`:\n   ```json\n   {\n     \"name\": \"\u003cname\u003e\",\n     \"displayName\": \"Human Readable Name\",\n     \"description\": \"What it does and when to use it\",\n     \"category\": \"documentation\",\n     \"tags\": [\"docs\", \"templates\"],\n     \"example\": \"Generate a README for this project\",\n     \"lastUpdated\": \"2026-01-01\"\n   }\n   ```\n   Derived fields (`type`, `skill_file_url`, `zip_file_path`) are filled in by the\n   build — you do not write them.\n3. Run `npm run prebuild` to regenerate `.claude-plugin/marketplace.json`, then\n   commit both files.\n\nSee [`docs/contribute/submit-best-practice.md`](docs/contribute/submit-best-practice.md)\nfor the full guide.\n\n## Federating other marketplaces\n\nAdd remote registry URLs to `marketplaceConfig.registries` in\n`docusaurus.config.js`. The website loads each one and shows a registry picker:\n\n```js\nregistries: [\n  \"./static/data/registry.json\",                          // your local catalog\n  \"https://nasa-ammos.github.io/slim/data/registry.json\",  // a remote marketplace\n],\n```\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE).\n\n## Credits\n\n- UI components adapted from [aitmpl.com](https://aitmpl.com) (MIT License).\n- Derived from the open-source SLIM Best Practices marketplace\n  ([NASA-AMMOS/slim](https://github.com/NASA-AMMOS/slim), Apache 2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Fslim-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasa-ammos%2Fslim-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Fslim-framework/lists"}