Capability Require Prompts

capability-require-prompts

info experience: data-modelingexperience: discoverability spec: capabilities

prompts should be present

The prompts property of each capability should be present.

Rule definition

The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.

capability-require-prompts:
  title: Capability Require Prompts
  reference: https://spotlight-rules.com/spec/rules/mcp/capability-require-prompts/
  description: The `prompts` property of each capability should be present.
  message: prompts should be present
  severity: info
  given: $.capabilities
  then:
    field: prompts
    function: truthy
  tags:
    - format:mcp
    - spec:capabilities
    - experience:data-modeling
    - experience:discoverability
  prompt: "You are editing a MCP document to satisfy the Spotlight API governance
    rule 'capability-require-prompts' (Capability Require Prompts). Requirement:
    The `prompts` property of each capability should be present. To fix: Ensure
    `prompts` is present and non-empty at each matching location. This rule is
    evaluated at the JSONPath `$.capabilities` — inspect every location it
    matches and correct only what violates the rule. Make the smallest change
    that satisfies the rule, leave all unrelated content, key order, comments,
    and formatting unchanged, and keep the document valid MCP. Return only the
    complete corrected document, with no commentary."
AI fix prompt — send this to Claude, Gemini, or ChatGPT with your artifact to auto-fix this rule
You are editing a MCP document to satisfy the Spotlight API governance rule 'capability-require-prompts' (Capability Require Prompts). Requirement: The `prompts` property of each capability should be present. To fix: Ensure `prompts` is present and non-empty at each matching location. This rule is evaluated at the JSONPath `$.capabilities` — inspect every location it matches and correct only what violates the rule. Make the smallest change that satisfies the rule, leave all unrelated content, key order, comments, and formatting unchanged, and keep the document valid MCP. Return only the complete corrected document, with no commentary.
ArtifactMCP
Applies at (given)$.capabilities
Severityinfo — educational by default; raise to warn/error to enforce
Referencehttps://spotlight-rules.com/spec/rules/mcp/capability-require-prompts/