Skill Manifest Examples

The skill manifest is the JSON representation of your skill, and provides Alexa with all of the metadata required for your skill. The interaction model and account linking schemas, if used, are separate. For details, see Skill Manifest Schema.

The following are some example skill manifests. For each skill type, ensure that you consider the privacy and compliance requirements.

Connected vehicle skill manifest

The following is an example of a skill manifest for a connected vehicle skill. For details, see Connected Vehicle Skills for Alexa.

Copied to clipboard.

{
  "vendorId": "<vendor id>",
  "manifest": {
    "publishingInformation": {
      "locales": {
        "en-US": {
          "summary": "This is a sample Alexa Remote Car Control skill for Provider.",
          "examplePhrases": [
            "Alexa, turn on my car",
            "Alexa, set the temperature to thirty in my car"
          ],
          "keywords": [
            "Remote Car Control",
            "RCSK",
            "RCSK skill",
            "Remote Car Control skill"
          ],
          "name": "Car Control Skills Kit",
          "description": "This skill has basic and advanced features to control vehicles."
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, turn on my car' 2) Say 'Alexa, turn on the heater in my car'",
      "category": "CONNECTED_CAR",
      "distributionCountries": ["US"]
    },
    "apis": {
      "smartHome": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
        },
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
            }
          }
        },
        "supportedControls": {
          "type": "REMOTE_VEHICLE_CONTROL"
        }
      }
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "containsAds": false,
      "isChildDirected": false,
      "isExportCompliant": false,
      "usesPersonalInfo": false,
      "locales": {
        "en-US": {
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com",
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com"
        }
      }
    }
  }
}

Custom skill manifest

Copied to clipboard.

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "en-US": {
          "summary": "This is a sample Alexa custom skill.",
          "examplePhrases": [
            "Alexa, open sample custom skill.",
            "Alexa, play sample custom skill."
          ],
          "keywords": [
            "Descriptive_Phrase_1",
            "Descriptive_Phrase_2",
            "Descriptive_Phrase_3"
          ],
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "name": "Sample custom skill name.",
          "description": "This skill does interesting things."
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, hello world'",
      "category": "HEALTH_AND_FITNESS",
      "distributionCountries": [
        "US",
        "GB",
        "DE"
      ]
    },
    "apis": {
      "custom": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
        },
        "interfaces": [
          {
            "type":"ALEXA_PRESENTATION_APL"
          },		
          {
            "type":"AUDIO_PLAYER"
          },
          {
            "type":"CAN_FULFILL_INTENT_REQUEST"
          },
          {
            "type":"GADGET_CONTROLLER"
          },
          {
            "type":"GAME_ENGINE"
          },
          {
            "type":"RENDER_TEMPLATE"
          },
          {
            "type":"VIDEO_APP"
          }		  
        ],
        "regions": {
          "NA": {
            "endpoint": {
              "sslCertificateType": "Trusted",
              "uri": "https://customapi.sampleskill.com"
            }
          }
        }
      }
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      },
      {
        "name": "alexa:devices:all:address:country_and_postal_code:read"
      },
      {
        "name": "alexa::household:lists:read"
      },
      {
        "name": "alexa::household:lists:write"
      },
      {
        "name": "alexa::alerts:reminders:skill:readwrite"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false,
      "locales": {
        "en-US": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "events": {
      "endpoint": {
        "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
      },
      "subscriptions": [
        {
          "eventName": "SKILL_ENABLED"
        },
        {
          "eventName": "SKILL_DISABLED"
        },
        {
          "eventName": "SKILL_PERMISSION_ACCEPTED"
        },
        {
          "eventName": "SKILL_PERMISSION_CHANGED"
        },
        {
          "eventName": "SKILL_ACCOUNT_LINKED"
        }
      ],
      "regions": {
        "NA": {
          "endpoint": {
            "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
          }
        }
      }
    }
  }
}

Flash briefing skill manifest

Copied to clipboard.

{
  "manifest": {
    "manifestVersion": "1.0",
    "publishingInformation": {
      "locales": {
        "en-US": {
          "name": "Sample skill name.",
          "summary": "This is a sample Alexa skill.",
          "description": "This skill has basic and advanced features.",
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "examplePhrases": [],
          "keywords": [
            "Flash Briefing",
            "News",
            "Happenings"
          ]
        }
      },
      "distributionCountries": [
        "US",
        "GB",
        "DE"
      ],
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, hello world'",
      "category": "HEALTH_AND_FITNESS"
    },
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
	  "containsAds": false,
      "locales": {
        "en-US": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "apis": {
      "flashBriefing": {
        "locales": {
          "en-US": {
            "customErrorMessage": "Error message",
            "feeds": [
              {
                "name": "feed name",
                "isDefault": true,
                "vuiPreamble": "In this skill",
                "updateFrequency": "HOURLY",
                "genre": "POLITICS",
                "imageUri": "https://fburi.com",
                "contentType": "TEXT",
                "url": "https://feeds.sampleskill.com/feedX"
              }
            ]
          }
        }
      }
    }
  }
}

List skill manifest

The following is a manifest for a list skill that has no custom component.

Copied to clipboard.

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "en-US": {
          "summary": "This is a sample Alexa skill.",
          "examplePhrases": [
            "Alexa, open sample skill.",
            "Alexa, play sample skill."
          ],
          "keywords": [
            "Descriptive_Phrase_1",
            "Descriptive_Phrase_2",
            "Descriptive_Phrase_3"
          ],
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "name": "Sample skill name.",
          "description": "This skill does interesting things."
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, hello world'",
      "category": "HEALTH_AND_FITNESS",
      "distributionCountries": [
        "US",
        "GB",
        "DE"
      ]
    },
    "apis": {
      "householdList": {}
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      },
      {
        "name": "alexa:devices:all:address:country_and_postal_code:read"
      },
      {
        "name": "alexa::household:lists:read"
      },
      {
        "name": "alexa::household:lists:write"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "locales": {
        "en-US": {
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com",
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com"
        }
      },
      "isExportCompliant": true,
      "containsAds": false,
      "isChildDirected": false,
      "usesPersonalInfo": false
    },
    "events": {
      "endpoint": {
        "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
      },
      "subscriptions": [
        {
          "eventName": "SKILL_ENABLED"
        },
        {
          "eventName": "SKILL_DISABLED"
        },
        {
          "eventName": "SKILL_PERMISSION_ACCEPTED"
        },
        {
          "eventName": "SKILL_PERMISSION_CHANGED"
        },
        {
          "eventName": "SKILL_ACCOUNT_LINKED"
        },
        {
          "eventName": "ITEMS_CREATED"
        },
        {
          "eventName": "ITEMS_UPDATED"
        },
        {
          "eventName": "ITEMS_DELETED"
        }
      ],
      "regions": {
        "NA": {
          "endpoint": {
            "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
          }
        }
      }
    }
  }
}

Meetings skill manifest

Copied to clipboard.

{
  "manifest": {
    "apis": {
      "alexaForBusiness": {
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:123456789:function:myFunctionName1"
            }
          }
        },
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:123456789:function:myFunctionName1"
        },
        "interfaces": [
          {
            "namespace": "Alexa.Business.Reservation.Room",
            "version": "1.0",
            "requests": [
              {
                "name": "Search"
              },
              {
                "name": "Create"
              },
              {
                "name": "Update"
              }
            ]
          }
        ]
      }
    },
    "manifestVersion": "1.0",
    "privacyAndCompliance": {
      "locales": {
        "en-US": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      },
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false
    },
    "publishingInformation": {
      "locales": {
        "en-US": {
          "name": "Room Booking Skill",
          "smallIconUri": "https://smallUri.example.com/small1.png",
          "largeIconUri": "https://largeUri.example.com/large1.png",
          "summary": "This is a sample Alexa skill.",
          "description": "This skill has Alexa for Business reservations features.",
          "examplePhrases": [
            "Alexa, book this room.",
            "Alexa, find a room at 3pm tomorrow."
          ],
          "keywords": [
            "Meetings",
            "Booking",
            "Alexa For Business"
          ],
          "updatesDescription": "This skill has updates that fix feature bugs."
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, Book this room'",
      "category": "CALENDARS_AND_REMINDERS",
      "distributionCountries": [
        "US"
      ]
    }
  }
}

Smart home skill manifest

Copied to clipboard.

{
  "manifest": {
    "manifestVersion": "1.0",
    "publishingInformation": {
      "locales": {
        "en-US": {
          "name": "Sample skill name.",
          "summary": "This is a sample Alexa skill.",
          "description": "This skill has basic and advanced smart devices control features.",
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "examplePhrases": [
            "Alexa, open sample skill.",
            "Alexa, blink kitchen lights."
          ],
          "keywords": [
            "Smart Home",
            "Lights",
            "Smart Devices"
          ]
        }
      },
      "distributionCountries": [
        "US",
        "GB",
        "DE"
      ],
      "isAvailableWorldwide": false,
      "testingInstructions": "1) Say 'Alexa, turn on sample lights'",
      "category": "SMART_HOME"
    },
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false,
      "locales": {
        "en-US": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "apis": {
      "smartHome": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
        },
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-west-2:010623927470:function:sampleSkillWest"
            }
          }
        }
      }
    }
  }
}

Video skill manifest

Copied to clipboard.

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "en-US": {
          "summary": "This is a sample Alexa skill.",
          "examplePhrases": [
            "Alexa, tune to channel 206",
            "Alexa, search for comedy movies",
            "Alexa, pause."
          ],
          "keywords": [
            "Video",
            "TV"
          ],
          "name": "VideoSampleSkill",
          "smallIconUri": "https://smallUri.example.com",
          "largeIconUri": "https://smallUri.example.com",
          "description": "This skill has video control features."
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "",
      "category": "SMART_HOME",
      "distributionCountries": [
        "US",
        "GB",
        "DE"
      ]
    },
    "apis": {
      "video": {
        "countries": {
          "US": {
            "catalogInformation": [
              {
                "type": "INGESTED_CONTENT_IDENTIFIER",
                "sourceId": "catalogName"
              },
              {
                "type": "LIVE_TV_MSO",
                "sourceId": "MSOId"
              }
            ]
          }
        },
        "locales": {
          "en-US": {
            "videoProviderTargetingNames": [
              "VideoSampleSkill",
              "TV provider"
            ],
            "features": [
              {
                "version": "1.0",
                "players": [
                  {
                    "logoImageUri": "https://logoImageUri.example.com",
                    "type": "AVS_3P_PROVIDED",
                    "uri": "https://webplayerUri.example.com/index.html",
                    "backgroundImageUri": "https://backgroundImageUri.example.com"
                  }
                ],
                "name": "VIDEO_WEB_PLAYER"
              }
            ]
          }
        },
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
        },
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
            }
          }
        },
        "protocolVersion": "3.0"
      }
    },
    "manifestVersion": "1.0",
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "locales": {
        "en-US": {
          "termsOfUseUrl": "https://www.termsofuse.skill.example.com",
          "privacyPolicyUrl": "https://www.myprivacypolicy.skill.example.com"
        }
      },
      "isExportCompliant": true,
      "isChildDirected": false,
      "usesPersonalInfo": false,
      "containsAds": false
    }
  }
}