# URSP3600 Skill Document Format Specification
# Standard format for packaging smart city projects

---

## Overview

A Skill document is a standardized JSON file that packages your complete smart city project. It can be installed onto an AI Agent, allowing the Agent to understand and work with your project.

---

## Required Structure

```json
{
  "metadata": {
    "project_name": "string",
    "domain": "string (transport|environment|energy|building|public_service)",
    "institution": "string",
    "course": "string",
    "creation_date": "YYYY-MM-DD",
    "version": "string"
  },
  "1_problem_definition": {
    "core_problem": "string",
    "scope": "string",
    "measurable_baseline_impact": ["string"],
    "user_profile": {
      "primary_users": "string",
      "secondary_stakeholders": ["string"]
    },
    "value_proposition": "string"
  },
  "2_system_logic": {
    "system_architecture": {
      "component_layers": {
        "sensing_layer": {
          "purpose": "string",
          "components": [{"name": "string", "details": "string"}]
        },
        "data_layer": {
          "purpose": "string",
          "components": [{"name": "string", "details": "string"}]
        },
        "logic_layer": {
          "purpose": "string",
          "components": [{"name": "string", "details": "string"}]
        },
        "presentation_layer": {
          "purpose": "string",
          "components": [{"name": "string", "details": "string"}]
        }
      },
      "data_flow": ["string"],
      "smart_capability_assessment": {
        "perception": "Full|Partial|None",
        "coordination": "Full|Partial|None",
        "prediction": "Full|Partial|None",
        "adaptation": "Full|Partial|None",
        "value_delivery": "Full|Partial|None"
      }
    }
  },
  "3_data_model": {
    "data_sources": {
      "hk_government_open_data": [
        {
          "source": "string",
          "dataset_name": "string",
          "url": "string",
          "access_method": "string",
          "update_frequency": "string",
          "coverage_note": "string"
        }
      ],
      "supplementary_data_sources": [
        {
          "source": "string",
          "method": "string",
          "data_type": "string",
          "note": "string"
        }
      ]
    },
    "data_architecture": {
      "flow": [
        {"stage": "string", "details": "string"}
      ]
    }
  },
  "4_bim_digital_twin_relation": "string",
  "5_ai_workflow_logic": {
    "ai_capabilities": ["string"],
    "implementation_path": {
      "no_code_option": "string",
      "code_option": "string",
      "hybrid_approach": "string"
    },
    "ai_agent_configuration": {
      "system_prompt": "string",
      "tools": ["string"],
      "input_format": "string",
      "output_format": "string"
    }
  },
  "6_interface_interaction_logic": {
    "user_interfaces": [
      {
        "name": "string",
        "target_users": "string",
        "key_features": ["string"],
        "technology": "string"
      }
    ],
    "interaction_patterns": ["string"]
  },
  "7_implementation_value": {
    "value_proposition": {
      "public_value": "string",
      "institutional_value": "string",
      "commercial_value": "string"
    },
    "feasibility_assessment": {
      "technical": "1-5",
      "economic": "1-5",
      "policy": "1-5",
      "social_acceptance": "1-5"
    },
    "risk_analysis": [
      {
        "risk": "string",
        "likelihood": "High|Medium|Low",
        "impact": "High|Medium|Low",
        "mitigation": "string"
      }
    ]
  }
}
```

---

## Example: Smart Parking Skill Document

See the output from running the workflow with:
- project_description: "CUHK campus students spend too much time finding parking spots"
- project_domain: "transport"

The Skill Generator node will produce a complete, valid JSON document following this format.

---

## How to Install a Skill Document

1. Save the JSON file as `my_skill.json`
2. In Coze Coding, create a new AI Agent
3. Go to the Agent's "Skills" tab
4. Click "Import Skill" and upload your JSON file
5. The Agent can now answer questions about your project using the packaged knowledge

---

## Validation Checklist

Before submitting, verify:
- [ ] All 7 sections are present
- [ ] JSON is valid (no syntax errors)
- [ ] All required fields are filled
- [ ] Data sources include actual URLs
- [ ] Smart capability assessment uses Full/Partial/None
- [ ] Feasibility scores are 1-5
- [ ] Risk analysis includes at least 2 risks