Creating a Hello World skill from an OpenAPI file
This tutorial teaches you how to import a simple "Hello World" skill through its OpenAPI file, publish the skill, and use it in the chat.
This tutorial covers the following steps:
- Before you begin
- Importing the skill
- Publishing skill
- Connecting to the app
- Running the skill in the legacy chat
Before you begin
Before you start importing the skill, you must comply with the following requirements:
- You must have access to a tenant.
- Your users must have builder permissions to develop skills.
- You must have an OpenAPI file with at least one skill. If you don't have any, download the
.zip
that contains demo skills by clicking the following Download button.- Extract any OpenAPI file in
.json
format to follow the tutorial.
- Extract any OpenAPI file in
Importing the skills
Follow the steps to import skills on watsonx Orchestrate:
- From the menu
, select Skill studio.
- Click Create skill, and select Import API.
- Choose From a file to import the OpenAPI file.
- Drop the OpenAPI file in the Drag and drop files here or click to upload field.
- Click Next.
- From the listed skills, select the skills that you want to import.
- Click Add.
The skills are imported on watsonx Orchestrate and appears as Ready to publish in the Skills page.
Publishing the skill
From the Skills page, follow the steps to publish each imported skill on watsonx Orchestrate:
- Search the skill that you want to publish.
- From the menu
, select Enhance this skill.
- Click Publish.
Now, the skill is available in the skill catalog.
Connecting to the app
Connect to the skill app and add each imported skill in your skill catalog. Follow the procedure to do it:
- From the Chat page, click Add skills from the catalog.
- Under All Apps, click the skill app tile.
- Click Connect app.
- Provide the connection credentials.
- For the demo skills available in this tutorial, set any data in the username and password fields. Example:
user
andpass
.
- For the demo skills available in this tutorial, set any data in the username and password fields. Example:
- Click Connect app.
- In the skill tile, click Add skill +.
The app is now connected and the skill is present in your skill catalog.
Running the skill in the legacy chat
Use the legay chat to run the skill. From the menu, click Chat to go to the legacy chat page. Start the skill through the chat or through the skill tile.

Parent topic: