Two tools with minimal but present schemas and descriptions. Both tools accept a single 'url' parameter with basic type and description. Descriptions are present but generic (18-29 chars each, below the 50-200 char LLM-optimized baseline). No input validation rules documented in descriptions. No output schemas visible. No error guidance. Tool names follow verb_noun pattern (describe_*, summarize_*) but lack specificity about expected behavior. No security/permission documentation. Error handling exists in implementation but is not surfaced to the LLM in tool definitions.

• Expand describe_github_repo description to: 'Fetch and return the short description text from a GitHub repository metadata section. Use this to get a one-line overview. Returns: markdown text (50-500 chars). Fails if repo is private or URL is malformed.'
• Expand summarize_github_repo description to: 'Download README and generate an LLM-powered summary (paragraph length). Slower than describe_* but provides detailed overview. Requires Ollama service online. Use this for deep understanding. Returns: markdown text (200-1000 chars).'
• Add parameter 'url' description: 'Full GitHub repository URL (https://github.com/owner/repo). Public repos only. Must be valid and accessible.'
• Document output as: 'Returns string (markdown-formatted text). describe_github_repo: 50-500 chars. summarize_github_repo: 200-1000 chars. May fail if repo is private or network timeout.'
• Add error guidance to descriptions: 'On failure: private repo returns error; malformed URL returns validation error; network timeout returns retryable error. Try with a public GitHub URL.'
• Add readOnlyHint: true to both tools in schema to signal they are safe to call without side effects.
• Add timeout and dependency documentation: 'summarize_github_repo requires Ollama service at http://windows:11434 (configurable). If unavailable, returns INTERNAL_ERROR. Consider adding fallback or health check.'
• Add parameter validation to tool implementations: validate URL format before HTTP fetch, return clear error like 'Invalid GitHub URL format. Expected https://github.com/owner/repo'.

Inferred effective spec: <=2025-11-25.

• Relies on Sampling (deprecated) - integrate directly with the LLM provider API