Skip to content

Support Claude Desktop as an install target #318

Description

@oleg-mastriukov

Summary

The current install method (npx skills add forcedotcom/sf-skills) does not work for Claude Desktop (claude.ai, including Cowork mode). It would be great to add support / documentation for installing these skills on Claude Desktop.

Evidence

  1. README usage table only lists CLI-style tools. The repo's own README states:

    Tool Usage
    Agentforce Vibes Skills are auto-installed and auto-updated
    OpenCode, Claude Code, Codex, Cursor, more npx skills add forcedotcom/sf-skills

    Claude Desktop / claude.ai is not listed as a supported target.

  2. npx skills add assumes a local skills folder. This install pattern works for tools that read skills as loose files from disk (e.g. Claude Code's ~/.claude/skills/<name>/SKILL.md, or equivalent folders for OpenCode/Cursor/Codex). Claude Desktop has no such user-facing folder to drop files into.

  3. Anthropic's own docs confirm Claude Desktop uses a different install mechanism. Per the Claude Help Center article "Use skills in Claude" (https://support.claude.com/en/articles/12512180-use-skills-in-claude), custom skills on Claude Desktop must be packaged as a .skill/ZIP file and uploaded manually through Customize > Skills > "+" > Create skill > Upload a skill. There is no folder-drop or CLI install path.

  4. agentskills.io lists "Claude" (claude.ai) as a separate integration from "Claude Code", each with its own instructions link — Claude Code points to https://code.claude.com/docs/en/skills (folder-based), while Claude (claude.ai) points to https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview (upload-based). This reinforces that the two are not interchangeable and a single npx skills add step can't cover both.

Request

Please consider:

  • Documenting how to package an individual skill folder from this repo as a .skill ZIP for manual upload to Claude Desktop, and/or
  • Extending the npx skills add CLI (or providing a separate script) to output a ready-to-upload .skill ZIP per skill, so Claude Desktop users don't have to build one by hand.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions