{
  "markdown": "# AI Plugin Marketplace\n\nA dedicated Codex marketplace for portable AI-extension tooling. It currently ships six plugins:\n\n| Plugin | Purpose |\n| --- | --- |\n| `okf` | Author, search, migrate, validate, lint, maintain, and curate [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) bundles. |\n| `ai-transmute` | Inspect and convert AI skills, commands, agents, hooks, plugins, instruction files, MCP/LSP configuration, and notebooks through auditable OKF intermediates. |\n| `ai-scholar` | Research a subject deeply, curate cited OKF knowledge, and design a human-approved Codex plugin. |\n| `github-docs-api` | Search, retrieve, and build upon GitHub documentation via the official GitHub Docs API. |\n| `kilo-qwen38-generation-policy` | Install a global Kilo Code plugin that enforces explicit Qwen3.8 request parameters. |\n| `local-model-workbench` | Plan and troubleshoot llama.cpp, Qwen3.8, MiniMax H3, ComfyUI, VS Code, and local-model workflows. |\n\nThe marketplace lives at [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json). All plugins are maintained in this repository and published by [xiuuu4499](https://github.com/xiuuu4499).\n\n## Scope\n\nAI Transmute understands Codex, Claude, GitHub Copilot, Grok Build, and Gemini CLI packaging. Its workflow is deliberately loss-aware:\n\n1. Inventory the source without changing it.\n2. Retrieve the relevant platform and component knowledge.\n3. Create and curate an OKF audit bundle for the conversion job.\n4. Render the target package.\n5. Validate the result and report exact mappings, approximations, omissions, and manual follow-ups.\n\nConversions are written to a new timestamped directory and contain:\n\n```text\nai-transmute/<timestamp>-<source>-to-<target>/\n├── package/     # converted target artifact\n├── okf/         # portable conversion record\n├── report.md    # fidelity and validation report\n└── job.json     # machine-readable job metadata\n```\n\nJupyter notebooks retain their cells, metadata, attachments, and code. Hosted AI notebooks or projects without a documented portable import API are rendered as import packs with manual setup instructions.\n\nAI Scholar uses a separate, evidence-led workflow:\n\n1. Collect official and independent sources, preserving a reviewable record of duplicates and exclusions.\n2. Prioritize retained sources, contradictions, uncertainty, and special cases.\n3. Build and curate a cited OKF knowledge bundle after each source import.\n4. Design a traceable plugin interface and present it for explicit human approval.\n5. Implement, validate, and hand off only the approved design.\n\nIts stateful job record prevents implementation before the review artifact records explicit approval. AI Scholar’s primary user interface is its `study`, `sources`, `knowledge`, `architect`, `review`, `implement`, `validate`, `maintain`, `doctor`, and `plan-mode` skills; its small Python CLI persists state and verifies gates. The optional curation hook is advisory and fail-open.\n\n## Install Codex CLI in a Codespace\n\nOpenAI's current macOS/Linux recommendation is the standalone installer. It installs in user space and does not require rebuilding or restarting the devcontainer:\n\n```bash\ncurl -fsSL https://chatgpt.com/codex/install.sh | sh\nhash -r\ncodex --version\n```\n\nThe standard Codespaces `PATH` already includes `~/.local/bin`. If a customized image does not, activate it in the current shell:\n\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\nhash -r\n```\n\nRun `codex` once and select a supported sign-in method if the CLI requests authentication.\n\nFor reproducible future container builds, put the same installer command in the consuming repository's devcontainer setup. That is optional for the current container and only takes effect on a later create or rebuild.\n\n## Install this marketplace\n\nFrom the root of this clone:\n\n```bash\ncodex plugin marketplace add \"$PWD\"\ncodex plugin add okf@ai-plugin-marketplace\ncodex plugin add ai-transmute@ai-plugin-marketplace\ncodex plugin add ai-scholar@ai-plugin-marketplace\ncodex plugin add github-docs-api@ai-plugin-marketplace\ncodex plugin add kilo-qwen38-generation-policy@ai-plugin-marketplace\ncodex plugin add local-model-workbench@ai-plugin-marketplace\n```\n\nStart a new Codex thread after installation so newly installed skills and hooks are loaded. The advisory hooks are fail-open: they provide capped validation context but do not rewrite files or grant permissions.\n\n## Plugin entry points\n\nThe `okf` plugin exposes the full OKF workflow plus a thin `gem` command router.\n\nAI Transmute exposes these skills:\n\n- `inspect` — detect the platform, components, dependencies, and portability hazards without writing output.\n- `plan` — produce a dry-run mapping and predicted loss report.\n- `convert` — perform a format-preserving conversion through an OKF job bundle.\n- `extract` — pull selected components from a package or extrapolate a package from a smaller artifact.\n- `transform` — redesign behavior while explicitly recording semantic changes.\n- `learn-format` — curate official specifications and local examples before enabling a format.\n- `feedback` — correct durable format knowledge, mappings, renderer behavior, or one conversion job.\n- `validate` — check sources, OKF bundles, target packages, and complete jobs.\n- `diff` — compare behavior and component inventories rather than filenames alone.\n- `doctor` — report required and optional runtime availability.\n\nAI Scholar exposes these skills:\n\n- `study` — initialize a research contract and auditable job.\n- `sources` — collect, deduplicate, rank, and retain source decisions.\n- `knowledge` — create and curate cited OKF concepts in source-priority order.\n- `architect` — design skills, scripts, hooks, and other surfaces from curated evidence.\n- `review` — present the complete design packet and record explicit approval or requested changes.\n- `implement` — enforce approval before building the approved plugin.\n- `validate` — check source provenance, job state, OKF curation, traceability, and package quality.\n- `maintain` — assess source drift and revise research without overwriting prior evidence.\n- `doctor` — diagnose missing dependencies and validation failures.\n- `plan-mode` — map a Codex Plan-mode plan to the current AI Scholar job state and required gates.\n\nGitHub Docs API exposes these skills:\n\n- `answer-short-question` — quickly look up and answer a focused question using the GitHub Docs Search and Article Body REST APIs.\n- `extract-github-sme-plugin` — create a new GitHub domain Subject Matter Expert agent plugin by combining GitHub Docs API content extraction with the ai-scholar research and design workflow.\n- `update-github-apis` — re-crawl the GitHub Docs API surface to detect documentation changes and refresh the plugin's knowledge base.\n- `write-api-script` — create a standalone shell or Python script that calls GitHub Docs APIs directly to fetch or process documentation content without AI tooling.\n\nKilo Qwen3.8 Generation Policy exposes:\n\n- `qwen38-generation-policy` — choose and audit named Qwen3.8 thinking/instruct profiles, with request-time enforcement supplied by the bundled Kilo plugin.\n\nLocal Model Workbench exposes:\n\n- `local-model-workbench` — plan, inspect, document, and troubleshoot local model workflows across Kilo, llama.cpp, llama-swap, ComfyUI, MiniMax H3, MCP, and VS Code.\n\n## Install Kilo integration\n\nAfter installing the Codex plugin from this marketplace, install its Kilo artifacts in the environment where Kilo runs:\n\n```bash\nplugins/kilo-qwen38-generation-policy/scripts/install-kilo-qwen38-policy.sh\n```\n\nPowerShell:\n\n```powershell\n.\\plugins\\kilo-qwen38-generation-policy\\scripts\\install-kilo-qwen38-policy.ps1\n```\n\nThe installer writes only owned files under `~/.config/kilo` by default and can be redirected with `KILO_TARGET_CONFIG_DIR`. The native implementation is Python; `.sh` and `.ps1` wrappers are provided for platform-native invocation. Run `/reload` in Kilo or restart Kilo after installation.\n\nUninstall:\n\n```bash\nplugins/kilo-qwen38-generation-policy/scripts/uninstall-kilo-qwen38-policy.sh\n```\n\n## Requirements\n\n- Python 3 for AI Transmute's deterministic engine and advisory hook.\n- Python 3 for AI Scholar's deterministic job engine and advisory hook.\n- Python 3 for the GitHub Docs API plugin's validation script.\n- The `okf` CLI for audited conversion and knowledge-catalog workflows.\n- Ruby for the OKF plugin's advisory curation hook.\n- Target-native CLIs are optional; when present, validation can use them in addition to internal checks.\n\nMissing optional tools are reported rather than installed automatically.\n\n## Development and validation\n\nRun the deterministic test suite:\n\n```bash\npython3 -m unittest discover -s plugins/ai-transmute/tests -v\npython3 -m unittest discover -s plugins/ai-scholar/tests -v\npython3 -m unittest discover -s plugins/github-docs-api/tests -v\npython3 -m unittest discover -s plugins/kilo-qwen38-generation-policy/tests -v\n```\n\nValidate the persistent knowledge catalog:\n\n```bash\nokf validate plugins/ai-transmute/knowledge\nokf lint plugins/ai-transmute/knowledge\nokf loose plugins/ai-transmute/knowledge\n```\n\nBefore committing an AI Scholar plugin change, also run:\n\n```bash\npython3 plugins/ai-scholar/scripts/ai_scholar.py init \"smoke test\" --output /tmp --json\npython3 /home/codespace/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/ai-scholar\n```\n\nPlugin manifests and skill folders can additionally be checked with the validators bundled with Codex's `plugin-creator` and `skill-creator` skills.\n\n## License\n\nRepository-authored code and documentation are available under the [MIT License](LICENSE). Vendored OKF reference material retains its upstream Apache 2.0 notice in [`plugins/okf/skills/okf/reference/APACHE-2.0.txt`](plugins/okf/skills/okf/reference/APACHE-2.0.txt).\n",
  "bytes": 9876,
  "sha": "3ef2e0c0d45fef2d0e88ed9ea97573126dc1558dfe10128626bf00e4c2985512",
  "repo_slug": "xiuuu4499/ai-plugin-marketplace",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_xiuuu4499_ai_plugin_marketplace_plugins__d189d3a6/readme"
}