{"id":21497719,"url":"https://github.com/huyle93/mapout","last_synced_at":"2025-03-17T12:26:33.016Z","repository":{"id":121941027,"uuid":"126189322","full_name":"huyle93/mapout","owner":"huyle93","description":"Hackathon Winning Voice Application","archived":false,"fork":false,"pushed_at":"2018-08-18T19:50:29.000Z","size":202,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-23T22:15:20.045Z","etag":null,"topics":["alexa-sdk","alexa-skill","alexa-voice-service","amazon","aws-lambda","custom-slot","hackathon","skill-architecture","xml","xml-rss"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huyle93.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-21T14:14:39.000Z","updated_at":"2023-03-09T14:25:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"f98095e4-d5d1-4f01-80f2-adc2e4536b1a","html_url":"https://github.com/huyle93/mapout","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huyle93%2Fmapout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huyle93%2Fmapout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huyle93%2Fmapout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huyle93%2Fmapout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huyle93","download_url":"https://codeload.github.com/huyle93/mapout/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244032166,"owners_count":20386720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alexa-sdk","alexa-skill","alexa-voice-service","amazon","aws-lambda","custom-slot","hackathon","skill-architecture","xml","xml-rss"],"created_at":"2024-11-23T16:26:13.948Z","updated_at":"2025-03-17T12:26:32.995Z","avatar_url":"https://github.com/huyle93.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alexa Dev Guideline\n\n- [AWS LAMBDA](https://aws.amazon.com/lambda/)\n- [AWS S3](https://aws.amazon.com/s3/)\n- [Amazon Developer Portal](https://developer.amazon.com/alexa)\n- [XML RSS 2.0 Specs](https://validator.w3.org/feed/docs/rss2.html)\n- [Alexa Skill Metadata](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/define-skill-metadata)\n- [Alexa Built-in Intents](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/implementing-the-built-in-intents)\n- [Alexa Voice Service](https://developer.amazon.com/avs)\n- [Alexa SDK Node Modules](https://www.npmjs.com/package/alexa-sdk)\n- [Tips for Skill Certification](https://developer.amazon.com/alexa-skills-kit/launch/#certification)\n\n---\n\n## Project Description\n\nThis is the complete project of building flash briefing skill and a custom interactive skill for Alexa. The custom interactive skill is also linked to the Alexa mobile app which showing image cards.\n\n---\n\n## Table of contents\n\n- [Quick start](#quick-start)\n- [Folder Structure](#folder-structure)\n- [Flash Briefing](#flash-briefing)\n- [Skill Architecture](#skill-architecture)\n- [Custom Slot](#custom-slot)\n- [File Format](#file-format)\n- [Developer Note](#developer-note)\n- [Creators](#creators)\n- [Copyright and license](#copyright-and-license)\n\n---\n\n## Quick Start\n\n[Amazon Developer Portal](https://developer.amazon.com/alexa) is the home of you Alexa skill. This is where you create the skill, manage skill information and information of your Lambda Function. In Alexa development, this service is called Skill Interface.\n\n[AWS Lambda](https://aws.amazon.com/lambda/) is a service to implement your code or function without running on a server. In Alexa developement, this service is called Skill Service\n\n[AWS S3](https://aws.amazon.com/s3/) Amazon requires all contents that used in Alexa skill is accessed by HTTPS so S3 is the best solution for the Alexa skill's content cloud storage\n\n[Alexa Voice Service](https://developer.amazon.com/avs) (AVS) is Amazon’s intelligent voice recognition and natural language understanding service that allows you as a developer to voice-enable any connected device that has a microphone and speaker.\n\nAdding package.json \"npm init\"\n\nAdding alexa sdk into your package.json using \"npm install --save alexa-sdk\"\n\n```\n{\n  \"name\": \"hacklbm\",\n  \"version\": \"1.0.0\",\n  \"description\": \"hi there. this is an interactive skills for amazon alexa echo built on node.js 6.10, serviced by AWS Lambda and Amazon Developer Portal. huyle.finance@gmail.com\",\n  \"main\": \"index.js\",\n  \"scripts\": {\n    \"test\": \"echo \\\"Error: no test specified\\\" \u0026\u0026 exit 1\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"yourrepo\"\n  },\n  \"keywords\": [\n    \"alexa\"\n  ],\n  \"author\": \"huy le huyle.finance@gmail.com\",\n  \"license\": \"ISC\",\n  \"dependencies\": {\n    \"alexa-sdk\": \"^1.0.11\"\n  }\n}\n```\nRunning \"npm install\" to add node_modules\n\n---\n\n## Folder Structure\n\n```\nAlexa-Project/\n├── skill/\n│   ├── intentSchema/\n│   │   └── intentSchema.JSON\n│   ├── speechAssets/\n│   │   ├── budgeting_Tips.txt\n│   │   ├── investing_Tips.txt\n│   │   └── utterances.txt\n│   ├── src/\n│   │   └──index.js\n└── flash-briefing/\n    ├── speechAssets/\n    │   └── audio.mp3\n    └── src/\n        ├── content.json\n        └── my-audio-content.xml\n```\n---\n\n## Flash Briefing\n\nA Flash Briefing provides a quick overview of news and other content such as comedy, interviews, and lists that a customer discovers and enables in the Skills section of the Alexa app\n\n![https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-flash-briefing-skill-api](https://developer.amazon.com/public/binaries/content/gallery/developerportalpublic/solutions/alexa/alexa-skills-kit/content-skill_diagram_540x420_asv2.png)\n\nAlexa Flash Briefing Feeds can be built by XML RSS or JSON. The content of the feeds need to be stored on HTTPS. In this project, I store them on AWS S3.\n\nFor this skill, I use XML RSS to implement the news. The XML file need to follow the feed reference of Amazon and W3 XML RSS 2.0.\n\n[Amazon Flash Briefing Feed Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/flash-briefing-skill-api-feed-reference)\n\n[XML RSS 2.0 Specs](https://validator.w3.org/feed/docs/rss2.html)\n\n### Sample XML RSS Feed item for Alexa:\n\n```\n\u003citem\u003e\n    \u003clink\u003ehttps://www.quora.com/\u003c/link\u003e\n    \u003cguid isPermaLink=\"false\"\u003ethis_is_a_unique_string_when_isPermaLink_false_just_to_make_for_keep_track_of_the_content\u003c/guid\u003e\n    \u003ctitle\u003eDeveloper news\u003c/title\u003e\n    \u003cdescription\u003e\u0026lt;p\u0026gt;Latest news for developers on Quora\u0026amp;nbsp;\u0026lt;/p\u0026gt;\u003c/description\u003e\n    \u003cpubDate\u003eMon, 17 Jul 2017 21:40:22 +0000\u003c/pubDate\u003e\n    \u003ccategory\u003egeneral:products/aws-lambda,marketing:marchitecture/compute,general:products/amazon-cloudfront\u003c/category\u003e\n    \u003cauthor\u003ehuyle.finance@gmail.com\u003c/author\u003e\n\u003c/item\u003e\n\n```\n\n---\n\n## Skill Architecture\n\n![https://developer.amazon.com/alexa-skills-kit#learn](https://images-na.ssl-images-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/homepage/ASK-page_build._CB529900201_.png)\n\nAlexa Skill Flow:\n\n- New Session\n- Launch Request (Invoke the skill without intent or data such as Alexa [Invocation Name], ex: Alexa, ask MyMoney)\n- Intent Request (Calling the [Invocation Name] with the intent of doing something, ex: Alexa, ask MyMoney for budgeting tips)\n- Session Ended Request (Exiting skill)\n\n---\n\n## Custom Slot\n\n[Amazon Slot Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)\n\n## File Format\n\n/speechAssets\n.txt\n.mp3\n\n/src\nNode.js 6.10\n\n/intentSchema\nJSON\n\n/imageAssets\n.png\n.jpg\n\n---\n\n## Developer Note\n\nAll content files are hosted on AWS S3 huyle.finance@gmail.com in f4m bucket\n\nflash briefing skill is on huyle.finance@gmail.com Amazon Developer account, named: beta prototype\n\nsrc node.js is hosted on AWS Lambda, huy's account.\n\nflash-briefing note: prefer XML format over JSON\n\n---\n\n## Creators\n\nHuy Le\n\nhuyle.finance@gmail.com\n\n---\n\n## Copyright and license\n\nHuy Le 2018","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuyle93%2Fmapout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuyle93%2Fmapout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuyle93%2Fmapout/lists"}