> ## Documentation Index > Fetch the complete documentation index at: https://docs.decimal.ai/llms.txt > Use this file to discover all available pages before exploring further. # List skills > List all skills for the organization. Returns enriched data including ownership info, agent associations, subscriber counts, and a `can_edit` flag for the current caller. Results are filtered by visibility — only skills the caller can see. ## OpenAPI ````yaml /openapi.json get /api/v1/skills openapi: 3.1.0 info: title: DecimalAI Platform description: Agent Dataset Lifecycle Platform — Backend API version: 0.1.0 servers: [] security: - BearerAuth: [] tags: - name: traces description: >- Ingest, search, and inspect agent execution traces. A trace is the atomic unit of the platform — every other feature (evaluation, compatibility scoring, dataset building) operates on traces. Each trace is auto-tagged with the manifest hash of the agent that produced it. - name: eval-scores description: >- Push, fetch, and aggregate per-trace evaluation scores. Scores carry source provenance (built-in, DeepEval, LangSmith, custom) and feed the unified decision engine, which produces a keep / repair / replay / drop verdict per trace. - name: skills description: >- Manage reusable instruction blocks (SKILL.md files) that modify agent behavior. Skills are first-class manifest components — changes to a skill appear in your regression-check impact reports. Use these endpoints to create, version, fork, and sync skills with your local SKILL.md files. - name: manifests description: >- Register and inspect manifest versions. A manifest is a snapshot of your agent's structural identity (tools, prompts, models, skills) at a point in time. The SDK registers manifests automatically; these endpoints expose the underlying records. - name: datasets description: >- Build versioned SFT/DPO training datasets from manifest-classified, eval-scored traces. Datasets are reproducible — each version locks the manifest and filter set used to build it. Export as JSONL, Parquet, or push to HuggingFace Hub. - name: replay description: >- Re-execute historical traces against a new manifest version. Replay is the deferred-future capability for behavioral verification of agent changes. The SDK creates a replay batch, your worker executes each task, then submits results back here for eval scoring. - name: registry description: >- Browse and install community skills from the public skills registry. Each registry skill carries a SkillScore — an evidence-tiered quality composite computed from real-world evals, benchmarks, and ratings across organizations. Installing creates a fork in your org — edits don't affect the public version. - name: agents description: >- List and inspect agents, plus their multi-agent topology (orchestrator → sub-agent edges discovered from traces). Agents are identified by a stable agent_name string set in your SDK init() call. - name: import description: >- Bulk-import historical traces from another observability platform or a JSONL backup. Useful for migrating from LangSmith / Braintrust / Langfuse. Duplicate trace IDs are silently skipped — re-running an import is safe. paths: /api/v1/skills: get: tags: - skills summary: List skills description: |- List all skills for the organization. Returns enriched data including ownership info, agent associations, subscriber counts, and a `can_edit` flag for the current caller. Results are filtered by visibility — only skills the caller can see. operationId: list_skills_api_v1_skills_get parameters: - name: category in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by category (e.g. 'tools', 'policies', 'workflows'). examples: - tools title: Category description: Filter by category (e.g. 'tools', 'policies', 'workflows'). - name: active_only in: query required: false schema: type: boolean description: Exclude soft-deleted skills. default: true title: Active Only description: Exclude soft-deleted skills. - name: project_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter to a single project. title: Project Id description: Filter to a single project. - name: name in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Exact-match filter on skill name — a 200/empty-list existence probe (the detail page uses it instead of a guaranteed-404 GET). title: Name description: >- Exact-match filter on skill name — a 200/empty-list existence probe (the detail page uses it instead of a guaranteed-404 GET). - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 description: Max results (1–500). default: 100 title: Limit description: Max results (1–500). - name: offset in: query required: false schema: type: integer minimum: 0 description: Pagination offset. default: 0 title: Offset description: Pagination offset. - name: Authorization in: header required: false schema: type: string title: Authorization - name: X-Workspace-Id in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Workspace-Id - name: decimal_session in: cookie required: false schema: anyOf: - type: string - type: 'null' title: Decimal Session responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListSkillsResponse' example: skills: - id: sk_abc123 name: search-flights description: Search available flights category: tools stability: stable is_active: true visibility: org latest_version_id: sv_def456 latest_version: version_number: 3 content_hash: a1b2c3d4e5f60718 change_summary: Added retry logic on timeout author: alice@example.com created_at: '2026-05-10T14:22:00Z' embedding_model: text-embedding-3-small trigger_phrases: - find flights activation_count: 142 agents: - agent_name: travel-agent activation_count: 142 agent_count: 1 owner: user_id: user_123 user_name: Alice workspace_id: ws_main workspace_name: Main can_edit: true subscriber_count: 0 effectiveness_score: 0.87 pass_rate: 0.91 success_rate: 0.93 trend: up source_type: platform created_at: '2026-04-01T09:00:00Z' total: 8 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: Python label: Python SDK source: |- from decimalai.skill_router import SkillRouter router = SkillRouter(api_key="dai_sk_...") skills = router.list_skills(category="tools", limit=50) - lang: Bash label: CLI source: decimalai skills list --limit 50 components: schemas: ListSkillsResponse: properties: skills: items: $ref: '#/components/schemas/SkillSummary' type: array title: Skills total: type: integer title: Total description: Total skills visible to the caller, after visibility filtering type: object required: - skills - total title: ListSkillsResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SkillSummary: properties: id: type: string title: Id name: type: string title: Name display_name: anyOf: - type: string - type: 'null' title: Display Name description: anyOf: - type: string - type: 'null' title: Description category: anyOf: - type: string - type: 'null' title: Category stability: type: string title: Stability description: 'One of: stable, experimental, deprecated' is_active: type: boolean title: Is Active visibility: type: string title: Visibility description: 'One of: org, workspace, personal, public' latest_version_id: anyOf: - type: string - type: 'null' title: Latest Version Id latest_version: anyOf: - $ref: '#/components/schemas/SkillVersionInfo' - type: 'null' embedding_model: anyOf: - type: string - type: 'null' title: Embedding Model trigger_phrases: anyOf: - items: type: string type: array - type: 'null' title: Trigger Phrases activation_count: type: integer title: Activation Count default: 0 agents: items: $ref: '#/components/schemas/SkillAgent' type: array title: Agents default: [] agent_count: type: integer title: Agent Count default: 0 owner: anyOf: - $ref: '#/components/schemas/SkillOwner' - type: 'null' can_edit: type: boolean title: Can Edit subscriber_count: type: integer title: Subscriber Count default: 0 effectiveness_score: anyOf: - type: number - type: 'null' title: Effectiveness Score pass_rate: anyOf: - type: number - type: 'null' title: Pass Rate success_rate: anyOf: - type: number - type: 'null' title: Success Rate trend: anyOf: - type: string - type: 'null' title: Trend sync_status: anyOf: - type: string - type: 'null' title: Sync Status last_synced_at: anyOf: - type: string - type: 'null' title: Last Synced At source_type: anyOf: - type: string - type: 'null' title: Source Type default: platform forked_from_skill_id: anyOf: - type: string - type: 'null' title: Forked From Skill Id forked_at_version_id: anyOf: - type: string - type: 'null' title: Forked At Version Id has_upstream_update: type: boolean title: Has Upstream Update default: false created_at: anyOf: - type: string - type: 'null' title: Created At type: object required: - id - name - stability - is_active - visibility - can_edit title: SkillSummary description: Skill row returned inside ListSkillsResponse.skills. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError SkillVersionInfo: properties: version_number: type: integer title: Version Number content_hash: type: string title: Content Hash description: SHA-256 of the body markdown, first 16 hex chars change_summary: anyOf: - type: string - type: 'null' title: Change Summary author: anyOf: - type: string - type: 'null' title: Author created_at: anyOf: - type: string - type: 'null' title: Created At description: ISO 8601 timestamp type: object required: - version_number - content_hash title: SkillVersionInfo SkillAgent: properties: agent_name: type: string title: Agent Name activation_count: type: integer title: Activation Count type: object required: - agent_name - activation_count title: SkillAgent SkillOwner: properties: user_id: anyOf: - type: string - type: 'null' title: User Id user_name: anyOf: - type: string - type: 'null' title: User Name workspace_id: anyOf: - type: string - type: 'null' title: Workspace Id workspace_name: anyOf: - type: string - type: 'null' title: Workspace Name type: object title: SkillOwner securitySchemes: BearerAuth: type: http scheme: bearer description: Enter your API key (e.g. dai_sk_test_key_001) ````