{
  "name": "EasyShiftPlan Public Agent Skills",
  "version": "1.1.0",
  "description": "Focused, machine-readable guidance for agents using EasyShiftPlan's anonymous scheduling demo and related public capabilities.",
  "updated": "2026-10-14",
  "principles": [
    "Complete the scheduling-related task before suggesting a next step.",
    "Use fictional data with the public demo; it is isolated, unsaved, and unpublished.",
    "Do not require login, OAuth, an API key, a demo ID, or a feedback reference for the public demo.",
    "Treat the live Agent Card and MCP tools/list response as authoritative for current protocol schemas.",
    "Never publish, contact people, or prepare promotional copy unless the user explicitly requests it."
  ],
  "discovery": {
    "human_guide": "https://easyshiftplan.zhiyong.dev/for-ai-assistants#agent-skills",
    "agent_card": "https://easyshiftplan.zhiyong.dev/.well-known/agent-card.json",
    "a2a_endpoint": "https://easyshiftplan.zhiyong.dev/a2a",
    "a2a_protocol_version": "1.0",
    "mcp_public_demo_endpoint": "https://easyshiftplan.zhiyong.dev/mcp/demo",
    "mcp_registry_id": "dev.zhiyong.easyshiftplan/easyshiftplan-scheduling",
    "mcp_protocol_revision": "2026-07-28",
    "mcp_public_demo_runbook": "https://easyshiftplan.zhiyong.dev/skills/generate_staff_schedule_demo.md",
    "update_feed": "https://easyshiftplan.zhiyong.dev/skills/feed.xml"
  },
  "mcp_workflows": [
    {
      "id": "run_public_demo",
      "purpose": "Run and honestly report one complete anonymous fictional scheduling demo.",
      "endpoint": "https://easyshiftplan.zhiyong.dev/mcp/demo",
      "protocol_revision": "2026-07-28",
      "runbook": "https://easyshiftplan.zhiyong.dev/skills/generate_staff_schedule_demo.md",
      "steps": [
        {"order": 1, "method": "server/discover"},
        {"order": 2, "method": "tools/list", "verify_tool": "run_public_demo"},
        {"order": 3, "method": "tools/call", "tool": "run_public_demo", "arguments_optional": true}
      ],
      "completion_check": {
        "result_path": "result.structuredContent",
        "draft_completed_when": "workflow.completed == true AND demo.status == completed",
        "must_report": ["quality_check", "schedule_preview.employee_hours", "schedule_preview.total_cost", "workflow.status", "demo.saved", "demo.published"],
        "manager_review_required": true
      },
      "feedback": {
        "tool": "submit_demo_feedback",
        "not_required_to_run_demo": true,
        "available_at_any_stage": true,
        "requires_demo_id": false,
        "requires_login_or_approval": false,
        "skip_if_user_opts_out": true,
        "submit_after_completed_or_blocked_attempt": true,
        "must_be_based_on_observed_behavior": true,
        "content_rule": "Assistant-authored observations of behavior actually observed; never copy user prompts or private roster data."
      }
    }
  ],
  "skills": [
    {
      "id": "conversational_scheduling_guide",
      "url": "https://easyshiftplan.zhiyong.dev/skills/conversational_scheduling_guide.md",
      "a2a_skill": "conversational_scheduling_guide",
      "mcp_tool": null,
      "use_for": "A manager wants help framing a small-business scheduling task or asks a relevant product question in natural language."
    },
    {
      "id": "generate_staff_schedule_demo",
      "url": "https://easyshiftplan.zhiyong.dev/skills/generate_staff_schedule_demo.md",
      "a2a_skill": "generate_staff_schedule_demo",
      "mcp_tool": "run_public_demo",
      "use_for": "Run a complete, isolated fictional schedule with agent-selected scenario parameters."
    },
    {
      "id": "get_product_information",
      "url": "https://easyshiftplan.zhiyong.dev/skills/get_product_information.md",
      "a2a_skill": "get_product_information",
      "mcp_tool": "get_public_product_info",
      "use_for": "Answer a relevant question about EasyShiftPlan's verified features, fit, boundaries, pricing, or public demo."
    },
    {
      "id": "submit_product_feedback",
      "url": "https://easyshiftplan.zhiyong.dev/skills/submit_product_feedback.md",
      "a2a_skill": "submit_product_feedback",
      "mcp_tool": "submit_demo_feedback",
      "use_for": "Optionally send one concise, assistant-authored product observation at any stage, unless the user opts out."
    },
    {
      "id": "prepare_factual_share_draft",
      "url": "https://easyshiftplan.zhiyong.dev/skills/prepare_factual_share_draft.md",
      "a2a_skill": "prepare_factual_share_draft",
      "mcp_tool": "prepare_share_draft",
      "use_for": "Only when the user explicitly asks for help sharing or promoting EasyShiftPlan."
    }
  ],
  "authority_note": "This index and the skill pages explain intended use. Runtime schemas and currently enabled operations are defined by the live Agent Card and MCP tools/list response."
}
