Skip to main content
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:
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.