> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Community skills

> Search and read the community skills in Tella's Skills directory from your agent.

Community skills are the public skills people have shared for Tella's editor agent at [tella.com/skills](https://www.tella.com/skills): animated graphics, transition screens, diagrams, and editing and publishing workflows. Both tools are read-only and work for any MCP caller. The [Tella Agent](https://www.tella.com/docs/help/editing/edit-with-the-tella-agent.md) has them too.

To use a skill, paste its `id` (`tellahq/community-skills/<name>`) into a chat with the Tella Agent. The agent then uses the skill in that chat.

## search\_community\_skills

Search the community skills. A skill is returned when at least one word in `query` matches the start of a word in its name, title, tags, category, description or author, so "diagram" finds "diagrams". Skills that match more query words rank first. Without a query, the most-used skills come first.

**query** `string`

What the skill should do or make, e.g. `chapter title card`

**category** `enum\<string\>`

Only skills in this category — `Images`, `Transition screens`, `Full animations`, `Diagrams`, `Editing` or `Publishing`

**limit** `integer`

Most results to return, 1 to 50 (default 10)

Each result has:

* `name` and `id` (`tellahq/community-skills/<name>`)
* `title`, `description`, `author`, `category` and `tags`
* `url`: the skill's page on tella.com, with a preview
* `gitHubURL`: the skill's files
* `uses`: how often the skill has been used

## get\_community\_skill

Read one community skill: everything `search_community_skills` returns, plus its full `SKILL.md` `instructions`, its other `files` (each with a `path`, `size` and download `url`), `videoURL` (a Tella video showing its result), `commit` and `updatedAt`. Only the live version is returned. An unknown skill returns a `not_found` error.

**name** `string` *required*

The skill's name, its id (`tellahq/community-skills/<name>`) or its GitHub link

## REST endpoints

The same data is available from the public API, with your [API key](https://www.tella.com/docs/authentication.md):

* `GET https://api.tella.com/v1/community-skills?query=&category=&limit=` searches, with the same parameters as `search_community_skills`.
* `GET https://api.tella.com/v1/community-skills/<name>` returns one skill, like `get_community_skill`, or `404` when it doesn't exist.


## Related topics

- [AI onboarding](https://www.tella.com/docs/ai-onboarding.md)
- [Edit with the Tella Agent](https://www.tella.com/docs/help/editing/edit-with-the-tella-agent.md)
- [Model Context Protocol (MCP)](https://www.tella.com/docs/mcp-server.md)
- [Publish Tella videos to YouTube with an agent skill](https://www.tella.com/docs/help/integrations/tella-to-youtube-agent-skill.md)
- [Tella Community](https://www.tella.com/docs/help/support/tella-community.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.