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

> ## Agent Instructions
> Choose User guide for browser tasks, Developers for CLI, SDK and external agents, and Administration for organization management.
> Confirm identity and organization/project context before operations. Documentation access does not grant ThinkPlatform permissions.
> Review side effects, verify changes with a read, and do not blindly retry an operation with an uncertain outcome.
> Use documented UI steps for the web app and documented public CLI or SDK interfaces for automation. Follow each page’s prerequisites and authentication requirements.

# Add project skills to an agent

> Upload a skill to a project and attach it to an agent.

Project skills provide reusable instructions and supporting files for agents in a project. They are separate from the coding-agent skills described under Developers.

## Before you begin

Sign in, select the intended organization and project, and ensure you have permission to upload skills and edit the agent. Prepare a skill folder or ZIP containing its `SKILL.md` and any supporting files needed by the instructions. Review the files before upload.

Place `SKILL.md` at the root of the selected folder. For a ZIP, place one `SKILL.md` at the ZIP root or inside a single top-level folder. Its frontmatter must contain a nonempty `name` and `description`. For example, a minimal `SKILL.md` can contain:

```markdown theme={"system"}
---
name: brief-summary
description: Summarize supplied text in a few bullets.
---

Summarize the text supplied by the user in three concise bullets.
```

Include supporting files under the same skill root when needed. The upload rejects duplicate skill folder names; choose a different folder name if one already exists. Folder uploads have a file-count limit set by the installation; the default is 200 files.

## Upload and attach

1. Open **AgentOps → Skills** in the project. Select **Upload Zip** or **Upload Folder**, then choose the prepared package.
2. Wait for the upload result. Find the skill in the list and open it to inspect its name, description, files, and `SKILL.md` content.
3. Open **AgentOps → Agents**, select the agent, and open its settings. Under **Skills**, select **Edit skills**, choose the project skill, and save the agent settings.
4. Open the agent's chat and give it a small request that exercises the skill. Inspect the response and any files against the skill's intended outcome.

If the upload succeeds but the list fails to refresh, use **Reload list**; another upload is not needed. For other errors, read the message and check the package and project access. If the skill is absent from the agent selector, confirm that you are in the intended project and that the upload appears in its Skills list. Bundled skills have a separate Shell requirement outside Sandbox; see [Create and configure an agent](https://docs.thinkplatform.ai/guides/agents/create-and-configure.md).


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