---
title: "List Available Skills"
method: GET
path: "/api/v1/skills/available"
tags: ["grep-public-api"]
---

# List Available Skills

`GET /api/v1/skills/available`

## Request

- Base URL: `https://api.grep.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grep.ai/api/v1/skills/available`
- Auth: none declared

List all available skills for research customization.

USER callers receive the filesystem catalog and their visible custom skills.
API-key and other caller modes receive the filesystem catalog only.

## Response `200`

Successful Response

- SkillsListResponse: Response for listing available skills.
  - `categories` string[], required
  - `skills` SkillInfo[], required
    - `can_edit` boolean: True when the caller may edit this skill
    - `can_publish` boolean: True only for Parcha admins
    - `can_share` boolean: True when the caller may manage this skill's access list
    - `category` string, required: Category: research, business, person, ui, other
    - `description` string, nullable: Description extracted from SKILL.md
    - `granted_to_me` boolean: True when the caller sees this skill through an ACL grant
    - `is_custom` boolean: True if the skill is a user/agent-builder-created skill not in the static catalog
    - `is_owned_by_me` boolean: True when the caller owns this custom skill
    - `is_owner` boolean: Compatibility alias for is_owned_by_me
    - `is_public` boolean: Readable and usable by all signed-in users
    - `is_shared` boolean: True when the caller sees this skill through an ACL grant
    - `name` string, required: Skill directory name (e.g., 'research-scientific-literature')
    - `owner_email` string, nullable: Compatibility alias for the custom skill owner
    - `owner_id` string, nullable: Owner email or user ID for a custom skill
    - `searchable_text` string, nullable: Concatenated text (name + description + tags + body excerpt) the picker uses for free-text search so the user can find skills by content, not just title.
    - `skill_files` string[]: Files stored in the custom skill directory, relative to its root
    - `skill_id` string, nullable: Stable database ID for a custom skill
    - `suggested_tools` string[]: MCP tool names (full mcp__server__tool identifier) the skill typically needs
    - `tags` string[]: Optional frontmatter tags / keywords surfaced for filtering and search
  - `total_count` integer, required

---

[API](https://skmtc.dev/grep/apis/grep-api.md) - [All operations](https://skmtc.dev/grep/apis/grep-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grep/apis/grep-api/revisions/3719dd7f43ec?raw)