{
  "markdown": "# ModelScope Skills\n\n**English** | [中文](README_ZH.md)\n\nModelScope Skills equip AI agents with the ability to operate on ModelScope — model/dataset management, Studio deployment, MCP service configuration, and Skills Center operations. It serves both ModelScope sites: the domestic site [modelscope.cn](https://modelscope.cn) and the international site [modelscope.ai](https://www.modelscope.ai). Compatible with Cursor, Claude Code, Codex, Gemini CLI, and other major coding agent tools.\n\nThis repository follows the [Agent Skills](https://agentskills.io/home) standard format.\n\n> [!NOTE]\n> Start by installing [`ms-hub`](skills/ms-hub/SKILL.md) — the unified entry point for the entire ModelScope platform, enabling your agent to perform most platform operations via the `ms` CLI, Python SDK, and OpenAPI.\n\n## Available Skills\n\n| Name | Description | Docs |\n|------|-------------|------|\n| `ms-hub` | Unified operations hub — model/dataset search/download/upload, repo management, Studio quick-ops, MCP services, Skills Center | [SKILL.md](skills/ms-hub/SKILL.md) |\n| `ms-studio-deploy` | Deploy local projects to Studios (Gradio / Streamlit / Docker / static), API-first workflow with auto-diagnosis | [SKILL.md](skills/ms-studio-deploy/SKILL.md) |\n\n> MCP service management and Skills Center publishing are now folded into `ms-hub`: common ops live in SKILL.md §8/§9, with depth in `ms-hub/references/mcp-services.md` and `skills-center.md`.\n\n## Installation\n\n### ModelScope CLI (universal)\n\n```bash\npip install modelscope\nmodelscope skills add @ModelScope/ms-hub\n# If the modelscope/ms entrypoint has no `skills` command (shadowed by modelscope_hub), use the more reliable:\n# curl -fsSL https://modelscope.cn/skills/install.sh | bash -s -- @ModelScope/ms-hub\n```\n\nSkills install to `~/.agents/skills/` by default, where major agent tools auto-discover them.\n\nAlternatively, install from source:\n\n```bash\ngit clone https://github.com/modelscope/modelscope-skills.git\ncp -r modelscope-skills/skills/ms-hub ~/.agents/skills/\n```\n\n### Cursor\n\nCopy the skill folders from `skills/` into your project's `.cursor/skills/` directory; Cursor auto-discovers the SKILL.md files there.\n\n### Claude Code\n\n```\n/plugin marketplace add modelscope/modelscope-skills\n/plugin install ms-hub@modelscope/modelscope-skills\n```\n\n### Codex\n\nCopy or symlink skill folders into `$HOME/.agents/skills` (or `$REPO_ROOT/.agents/skills`).\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/modelscope/modelscope-skills.git --consent\n```\n\n## Usage\n\nOnce installed, just tell your agent what you need:\n\n- \"Download Qwen2.5-7B-Instruct\"\n- \"Deploy this project to ModelScope Studios\"\n- \"Find a map MCP service and configure it in Cursor\"\n- \"Publish my Skill to the Skills Center\"\n\nThe agent automatically loads the relevant Skill and executes.\n\n## Prerequisites\n\n```bash\npip install modelscope\nexport MODELSCOPE_API_KEY=\"your_token\"   # from the target site's /my/myaccesstoken\n# Optional — pick a site (default: domestic modelscope.cn):\nexport MODELSCOPE_ENDPOINT=\"https://www.modelscope.ai\"   # international; omit for domestic\n```\n\n## Sites (domestic / international)\n\nModelScope runs two sites with separate accounts, tokens, and catalogs:\n\n| Site | Endpoint (`MODELSCOPE_ENDPOINT`) | Token page |\n|------|----------------------------------|-----------|\n| Domestic (default) | `https://modelscope.cn` | https://modelscope.cn/my/myaccesstoken |\n| International | `https://www.modelscope.ai` | https://www.modelscope.ai/my/myaccesstoken |\n\n`MODELSCOPE_ENDPOINT` reroutes the OpenAPI base, CLI, SDK, and git URLs in one shot. Access tokens are **site-scoped** — use the token issued by the site you target. The skills detect the intended site from `MODELSCOPE_ENDPOINT` / your token / explicit intent and default to the domestic site when unspecified. See [`ms-hub`](skills/ms-hub/SKILL.md) → \"Site selection & endpoint routing\".\n\n## Skill Architecture\n\n```\nms-hub (unified entry / quick reference)\n ├── Hub model/dataset/repo operations\n ├── MCP service search·deploy·configure  → references/mcp-services.md\n ├── Skills Center search·install·publish  → references/skills-center.md\n └── ms-studio-deploy (full Studio deployment workflow, API-first)\n```\n\n`ms-hub` covers common operations as quick-reference commands; MCP and Skills Center depth lives in references, while the multi-step Studio deployment is split out into `ms-studio-deploy`.\n\n## Contributing\n\n1. Create a new folder under `skills/`\n2. Write `SKILL.md`:\n   ```markdown\n   ---\n   name: my-skill\n   description: What it does and when to activate\n   ---\n\n   # Title\n   Guidance + examples + guardrails\n   ```\n3. Add scripts, templates, reference docs as needed\n4. Submit a PR\n\n## License\n\nApache License 2.0\n\n## Links\n\n- [ModelScope Documentation](https://modelscope.cn/docs/)\n- [ModelScope Skills Center](https://modelscope.cn/skills)\n- [ModelScope MCP Plaza](https://modelscope.cn/mcp)\n- [Agent Skills Standard](https://agentskills.io/home)\n",
  "bytes": 4997,
  "sha": "d3de1890ab3ce095ccea955046326ce227543b392ff83eb536fe2d21d520c3ba",
  "repo_slug": "modelscope/modelscope-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_modelscope_modelscope_skills_6734af64/readme"
}