A skills/features module for nmBot providing utility functions for mini app integration
Single tool 'miniAppStartLink' has a clear, descriptive name and reasonable description (156 chars), but critical gaps undermine quality. Input schema is present with proper types and descriptions for both parameters, including a sensible default. However, no output schema is documented, LLMs cannot plan downstream actions or validate the returned link format. The tool lacks error handling guidance (what if username is invalid? what if encoding fails?), no security considerations are documented, and no indication of idempotency or side effects. The implementation is simple and read-only, but the MCP definition is incomplete for production use.
Generates a mini app start link for nmBot. The mini app start link allows users to start a mini app within nmBot by clicking the link. The link is generated based on the bot's username and the specified path for the mini app.
No output schema documented. LLMs cannot infer the return type (string URL) or validate the response structure.
No error handling guidance. Tool lacks recovery hints for invalid inputs (e.g., empty username, encoding failures).
No input validation constraints documented. Username format (no '@' symbol) is mentioned but not enforced via schema pattern or enum.
Tool description does not state WHEN to use it or what the returned link enables. Lacks context for LLM selection.
No idempotency guarantee stated. Tool appears stateless, but this should be explicit for agent retry safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 42 | 2026-07-28+ | v2 |