Skills
Retrieve a skill
Retrieve one skill’s full content by name, including pre-built h/ skills.
GET
/
api
/
v2
/
skills
/
{name}
from hai_agents import Client
client = Client()
skill = client.skills.get_skill(name="extract-table-data")
print(skill.body)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const skill = await client.skills.getSkill({ name: "extract-table-data" });
console.log(skill.body);
curl "https://agp.eu.hcompany.ai/api/v2/skills/extract-table-data" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"name": "extract-table-data",
"description": "Use when the task asks for data in an HTML table.",
"body": "When you encounter an HTML table, extract all rows and columns into a JSON array of objects, using the headers as keys.",
"source": null,
"url_pattern": null,
"compatibility": null,
"files": {},
"executable_files": []
}
Path parameters
string
required
The skill’s
name, for example extract-table-data or myorg/web-helper.Response
200 with the skill object, also returned by create, list, update, and patch. Field constraints are on Create a skill.
string
Catalog identifier.
h/ names are H’s reserved, read-only skills.string
When to use the skill.
string
Markdown instructions the agent loads when it uses the skill.
string | null
Provenance URL.
string | null
Regex hinting at URLs where the skill applies.
string | null
Environment requirements shown to the agent.
from hai_agents import Client
client = Client()
skill = client.skills.get_skill(name="extract-table-data")
print(skill.body)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const skill = await client.skills.getSkill({ name: "extract-table-data" });
console.log(skill.body);
curl "https://agp.eu.hcompany.ai/api/v2/skills/extract-table-data" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"name": "extract-table-data",
"description": "Use when the task asks for data in an HTML table.",
"body": "When you encounter an HTML table, extract all rows and columns into a JSON array of objects, using the headers as keys.",
"source": null,
"url_pattern": null,
"compatibility": null,
"files": {},
"executable_files": []
}
Errors
| Status | Cause |
|---|---|
404 | Not found, or not in your organization. |
Was this page helpful?
⌘I
from hai_agents import Client
client = Client()
skill = client.skills.get_skill(name="extract-table-data")
print(skill.body)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const skill = await client.skills.getSkill({ name: "extract-table-data" });
console.log(skill.body);
curl "https://agp.eu.hcompany.ai/api/v2/skills/extract-table-data" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"name": "extract-table-data",
"description": "Use when the task asks for data in an HTML table.",
"body": "When you encounter an HTML table, extract all rows and columns into a JSON array of objects, using the headers as keys.",
"source": null,
"url_pattern": null,
"compatibility": null,
"files": {},
"executable_files": []
}