Dev & Engineering mcp-serverdeep-researchcode-generationweb-searchlsp-validationfile-editingasync-tasks

MS-Agent Capability Gateway

Expose 30 MCP tools for deep research, document/financial analysis, code & video generation, web search, LSP validation, and agent delegation.

FollowSkills review · FSRS-2.0
Not recommended
37/ 100 5-point scale 1.9 / 5
1 2 3 4 5 6
1Trust8 / 25 · 1.6/5

The skill exposes a wide range of tools via MCP (deep research, code generation, video generation, file editing), but provides no permission controls, user confirmation mechanisms, or data-flow transparency. Documentation claims code generation runs in a Docker sandbox, but the enforcement and isolation are unverified. File editing tools can modify arbitrary paths without path restrictions or confirmation. Dependencies (e.g., akshare, pyright) are not security-audited. External effects are significant (e.g., generating videos, writing files), and no rollback mechanism is provided. Publisher is unverified, but source attribution is traceable (Apache-2.0, public repo). Score is below the anchor of 12, hence deductions.

2Reliability4 / 20 · 1.0/5

SKILL.md and reference files provide detailed self-consistent instructions, including async patterns, parameters, and SOPs, but no executable or reproducible test evidence is provided. Although CI workflows and test files exist, the test file (e.g., test_partial_round.py) covers framework logic, not the skill's key paths (research, codegen, video). Thus, key path reproducibility is unverified. Error handling is documented, but actual failure cases are missing. Score is below the anchor of 10.

3Adaptability9 / 15 · 3.0/5

The skill clearly defines target audience (users needing deep research, code generation, etc.) and scenarios, and provides a quick decision guide for trigger conditions. However, non-fit boundaries are not explicitly stated, e.g., would it falsely trigger for simple summaries? Environment fit: dependencies on LLM APIs (e.g., ModelScope, OpenAI, Google) may have limited reachability from mainland China, and the docs do not address mainland China network access. Hence, deduct from the anchor of 15.

4Convention10 / 15 · 3.3/5

Documentation is well-structured with progressive disclosure (SKILL.md overview, reference files for details). Install and dependency notes are provided (e.g., pip install ms-agent), plus configuration examples for nanobot, OpenClaw, and Hermes. Parameters and tool naming are stable. Known limitations are disclosed (e.g., dependency on search API availability). License (Apache-2.0) and version (1.0.0) are given, but there is no changelog or maintenance responsibility statement. Publisher identity is unverified, but license and repo are public. Score is below the anchor of 15.

5Effectiveness4 / 15 · 1.3/5

The skill describes capabilities (research, codegen, etc.), but provides no actual output examples or validation results. Claimed outputs like reports and videos are said to be directly usable, but there is no evidence they are verified. After completing the core task, outputs may require heavy rework, e.g., report quality depends on LLM. Thus, score is far below the anchor of 7.

6Verifiability2 / 10 · 1.0/5

Only author-provided documentation and examples, no third-party execution evidence. CI workflows and tests exist, but do not cover the skill's key paths. Claims cannot be independently reproduced. Score is far below the anchor of 5.

Evidence confidence:Low Reviewed Aug 07, 2026 Reviewed revision 071b43325c56
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • The skill grants broad access to filesystem and external services without permission controls or user confirmation. Review configuration to ensure least privilege before deployment.
  • The skill claims code and financial research run in Docker sandboxes, but there is no evidence of enforcement. Verify that sandboxing is mandatory.
  • The skill depends on multiple external APIs (e.g., LLM providers, search APIs) that may have limited availability in mainland China. Ensure required services are reachable from your network.
  • No rollback or undo mechanism is provided. Exercise caution with file editing tools and maintain backups.
  • Publisher is unverified; independently assess security based on repository contents.
See the full review method →

What does this skill do, and when should you use it?

This skill connects an agent to the MS-Agent Capability Gateway, a unified interface to ms-agent's projects, components, and atomic tools, exposed as MCP tools. It provides a rich set of capabilities including deep research, document research, financial research, web search (arxiv/exa/serpapi), code generation, video generation, LSP code validation (TypeScript/Python/Java), concurrent-safe file editing, and agent delegation. All project-level operations support an async submit/check/get pattern, allowing the agent to continue handling other messages while long-running tasks execute in the background. Requires the ms-agent Python package and MCP server configuration.

Executes MCP tool calls: submits deep research tasks, polls progress, retrieves reports; submits document research tasks and fetches reports; submits financial research tasks and fetches reports; performs web searches with selectable engines; submits code generation tasks and retrieves results; submits video generation tasks and retrieves results; delegates tasks to sub-agents (sync or async); checks directories or incrementally updates and validates files via LSP; replaces file contents via content-match or line-range. All async operations follow a submit/poll/get pattern.

  1. A researcher needing an in-depth investigation on a complex topic can submit an async research task and continue other work while it runs.
  2. A data analyst analyzing uploaded documents or URLs wants a structured research report with charts.
  3. A financial analyst wants to aggregate quantitative financial data and news sentiment into a professional report for a stock.
  4. A developer wants to generate a complete software project from a natural-language requirement and validate code correctness via LSP.
  5. A content creator wants to generate a short video (~5 min) including script, storyboard, voiceover, and subtitles.
  6. An agent needs to delegate a complex multi-step task to another agent and optionally cancel it if no longer needed.

What are this skill's strengths and limitations?

Pros
  • Rich toolset (30 capabilities) covering research, code, video, and more in one gateway.
  • All project-level capabilities support async patterns, so the agent isn't blocked and can handle other messages.
  • Works with multiple agent hosts: nanobot, OpenClaw, Hermes, Cursor/Claude Desktop.
  • Code validation via LSP supports TypeScript, Python, and Java.
  • Provides concurrent-safe file editing tools.
Limitations
  • Requires separate installation of the ms-agent Python package, adding deployment overhead.
  • MCP server configuration is mandatory and differs per host, with a need to set PYTHONPATH.
  • Async tasks require manual polling; there's no automatic completion notification.
  • The SKILL.md doesn't mention a test suite or specific model compatibility.
  • Some advanced features (financial research, video generation) may require additional API keys (EXA, SERPAPI, T2I) and can take hours to complete.

How do you install this skill?

First install the ms-agent Python package via pip (pip install ms-agent). Then configure the MCP server in your agent host's config: nanobot uses config.json, OpenClaw uses openclaw.json, Hermes uses config.yaml. Follow the exact JSON/YAML examples in SKILL.md.

How do you use this skill?

After configuration, all tools are available as MCP tools with a prefix depending on your host (e.g., nanobot: mcp_ms-agent_web_search, OpenClaw: ms-agent_web_search, Hermes: mcp_ms-agent_web_search, Cursor/Claude Desktop: no prefix). For async tasks, submit to get a task_id, poll progress, then fetch the final result. Refer to the Quick Decision Guide in SKILL.md to choose the right tool.

How does this skill compare with similar options?

This skill is similar to Anthropic's Agent Skills implementation, but the main difference is that it exposes capabilities as MCP tools rather than filesystem-based skill directories.

FAQ

What API keys do I need?
Basic functionality requires a ModelScope API key (set MODELSCOPE_API_KEY). Deep research may need search API keys (EXA or SERPAPI); FinResearch needs OpenAI-compatible API keys; video generation needs additional keys (e.g., T2I_API_KEY). See the README for details.
How do I check progress on async tasks?
Submit a task to get a task_id, then poll with check_*_progress or check_*_task functions, typically every few minutes. Once completed, fetch the final result with get_*_result or get_*_report.
What happens if I don't configure the MCP server?
The skill won't work. You must configure the MCP server for your host as described in SKILL.md, ensuring ms-agent is installed and PYTHONPATH points to the ms-agent directory.
Which programming languages does code validation support?
Currently TypeScript, Python, and Java via the Language Server Protocol (LSP).

More skills from this repository

All from modelscope/ms-agent

Related skills