The Jobweave Claude Code Skill

This is Layer C — a different thing from the 16 AI Skills on the rest of this page's sibling pages, and from the 81 MCP tools. It's a single distributable SKILL.md plugin that teaches a coding agent (Claude Code, or any client that supports the Skill format) how to use Jobweave's MCP tools and CLI correctly — auth flow, scope model, error semantics — without re-deriving them from scratch every session.

There is exactly one packaged skill in this repo: jobweave-mcp, at skills/jobweave-mcp/SKILL.md. It exists because a directory skills/<name>/SKILL.md exists — that predicate, not a manifest, is what makes something a packaged skill here (duplicated identically across bin/generate-skill-package-json.mjs, bin/sync-skill-content.mjs, and bin/validate-skill-package.mjs).

What it does

Documents both ways to reach Jobweave data from an agent session: the jobweave MCP server (@jobweave/mcp-tool-server, stdio and remote-HTTP) when connected, and the offerly-mcp CLI as a fallback for a shell, CI, a container, or a session where the MCP server failed to start. It encodes the parts that are easy to get wrong: tool errors are answers, not crashes (a non-2xx response comes back as an MCP tool error carrying the API's own status/error/code, and should be reported rather than retried); scopes are per-resource-and-verb rather than blanket (15 total, from packages/mcp-tool-server/src/core/constants.ts); and there is no interactive auth flow at all — a pre-issued ofmcp_-prefixed service token, or the request fails, by design.

Alternative Installation Methods

Claude Code Plugin Marketplace

/plugin marketplace add catesandrew/offerly
/plugin install jw

npm package (@job-weave/skill-jobweave-mcp)

npx skills add @job-weave/skill-jobweave-mcp -g

Skills CLI, direct from the repo

npx skills add git@github.com:catesandrew/offerly.git --skill skills/jobweave-mcp -g

The npm channel is gated by an allowlist at docs/published-skills.json — currently just @job-weave/skill-jobweave-mcp — separate from the plugin-marketplace channel, which is driven by .claude-plugin/marketplace.json.

What it will not do

It is not the MCP server itself, and it is not one of the 16 AI Skills — installing it teaches an agent how to call the MCP tools and CLI correctly, it doesn't add any new capability to the product.

Source

skills/jobweave-mcp/SKILL.md · packages/skill-jobweave-mcp/ (npm mirror, kept in sync via node bin/sync-skill-content.mjs --all) · docs/published-skills.json · .claude-plugin/marketplace.json