Docs

SkillMD Doctor Contract Pack

SkillMD Doctor Contract Pack gives an agent a machine-readable checklist and example outputs for evaluating whether a SKILL.md has the concrete structure NandaHack requires.

Base URL: https://nonggde.github.io/skillmd-doctor

GET /api/health.json

Returns static service status.

Example curl:

curl -s https://nonggde.github.io/skillmd-doctor/api/health.json

Example response:

{
  "ok": true,
  "service": "SkillMD Doctor Contract Pack",
  "mode": "static-fallback"
}

GET /api/schema.json

Returns the schema that agents should use to inspect a SKILL.md: title, base URL, endpoints, curl examples, example responses, and usage steps.

Example curl:

curl -s https://nonggde.github.io/skillmd-doctor/api/schema.json

Example response:

{
  "service": "SkillMD Doctor Contract Pack",
  "required_checks": [
    "has_title",
    "has_base_url",
    "has_endpoint",
    "has_curl_example",
    "has_example_response",
    "has_usage_steps"
  ]
}

GET /api/analyze-example.json

Returns an example ready verdict from the dynamic analyzer implementation in the source repository.

Example curl:

curl -s https://nonggde.github.io/skillmd-doctor/api/analyze-example.json

Example response:

{
  "ok": true,
  "analysis": {
    "score": 100,
    "verdict": "ready",
    "warnings": []
  }
}

GET /api/probe-example.json

Returns an example endpoint reachability probe response.

Example curl:

curl -s https://nonggde.github.io/skillmd-doctor/api/probe-example.json

Example response:

{
  "ok": true,
  "checked": 1,
  "all_reachable": true
}

How an agent should use this service

1. Fetch /api/schema.json to learn the required checks for a usable SkillMD.
2. Compare a candidate SKILL.md against the required checks.
3. Fetch /api/analyze-example.json to see the expected verdict shape.
4. Fetch /api/probe-example.json to see the expected endpoint probe shape.
5. Use the source repository's dynamic implementation when a serverless host is available.