Skip to main content
hc
Submit
skillsFirst-partyReview first Safety ✓ Privacy ✓
Raycast logo

Raycast Extension Dev Publish Capability Pack Skill

Expert Raycast extension capability skill for command design, extension architecture, testing, and store-ready publication workflows.

by JSONbored·added 2026-04-10·
Claude CodeCodexWindsurfGeminiCursorCLIRaycast
HarnessClaude CodeCodexWindsurfGeminiCursorCLIRaycast
Level:expertType:capability-packVerified:validated
Review first — review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Canonical URL
https://heyclau.de/entry/skills/raycast-extension-dev-publish-capability-pack
Source URLs
https://developers.raycast.com/, https://github.com/JSONbored/awesome-claude/blob/main/content/skills/raycast-extension-dev-publish-capability-pack.mdx
Brand
Raycast
Brand domain
raycast.com
Brand asset source
brandfetch
Package URL
/downloads/skills/raycast-extension-dev-publish-capability-pack.zip
Package SHA256
27bea14be236882b4fbb89528b3f0229e0f27a18441c188269d833effef5bfb8
Safety notes
Installs from a downloaded package and may run local commands or scaffold files as part of the workflow; review the package and any generated changes before applying.
Privacy notes
Operates on your local project files and any context you share in the session; review what you expose before sharing — nothing is sent beyond the model unless a step calls an external service.
Platform compatibility
claude-code (native-skill), codex (native-skill), windsurf (native-skill), gemini (native-skill), cursor (adapter), cli (manual-context)
Author
JSONbored
Claim status
unclaimed
Last verified
2026-04-10

Decision playbook

Ready to evaluate for your workflow

Signals are comparatively strong, but you should still validate source, privacy posture, and package provenance for your environment.

Compare context
Selected

0

Current score

96

Baseline

—

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Complete

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done

  • Source provenance statusRequired

    Marked as first-party.

    Done

  • Metadata reviewed

    Registry metadata indicates a reviewed listing.

    Done

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done

  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done

  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Complete

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done

  • Package verification flag

    Package marked verified.

    Done

  • Checksum metadata

    SHA-256 hash is present.

    Done

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending

  • Baseline comparison available

    No baseline peer selected yet.

    Pending

  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

Package install

Copy-ready — paste the snippet to get started.

Install command

Provided

Config snippet

Not provided

Copy snippet

Provided

Prerequisites

3 to clear

Platforms

7 listed

Difficulty

76/100

Adoption plan

Balanced adoption plan

Current risk score 0/100. Use staged verification before broader rollout.

Risk 0

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done

  • Confirm metadata review state

    Listing has review metadata.

    Done

  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done

  • Review privacy notesRequired

    Privacy notes are present.

    Done

  • Verify package integrity metadata

    Package verification/checksum metadata is available.

    Done

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending

  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending

  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Required evidence gates are covered (6/6 signals complete).

Risk 0

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Present

Review metadata is present.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Present

Package integrity metadata is present.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required evidence gates are covered for this preset.

Decision timeline

Decision timeline · balanced

6/6 steps complete with no blocking gaps for this preset.

Risk 0

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is available.

Done

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is available.

Done

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

No required blockers for this timeline preset.

Prerequisite readiness

Prerequisite readiness

3 prerequisites to line up before setup.

0/3 ready
Configuration1General2

Safety & privacy surface

Safety & privacy surface

1 safety and 1 privacy notes across 2 risk areas. Review closely: credentials & tokens, network access.

2 areas
  • SafetyNetwork accessInstalls from a downloaded package and may run local commands or scaffold files as part of the workflow; review the package and any generated changes before applying.
  • PrivacyCredentials & tokensOperates on your local project files and any context you share in the session; review what you expose before sharing — nothing is sent beyond the model unless a step calls an external service.

Safety notes

  • Installs from a downloaded package and may run local commands or scaffold files as part of the workflow; review the package and any generated changes before applying.

Privacy notes

  • Operates on your local project files and any context you share in the session; review what you expose before sharing — nothing is sent beyond the model unless a step calls an external service.

Prerequisites

  • Raycast extension project setup
  • Product use case and command plan
  • API access for external integrations

Schema details

Install type
package
Reading time
8 min
Difficulty score
76
Troubleshooting
Yes
Breaking changes
No
Package metadata
Package verified
Yes
SHA-256
27bea14be236882b4fbb89528b3f0229e0f27a18441c188269d833effef5bfb8
Skill and platform metadata
Skill type
capability-pack
Skill level
expert
Verification
validated
Verified at
2026-04-10
Retrieval sources
https://developers.raycast.com/https://developers.raycast.com/basics/getting-startedhttps://developers.raycast.com/basics/publish-an-extension
Tested platforms
ClaudeCodexOpenClawCursorWindsurfGemini
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Apply the Raycast extension dev/publish capability pack to this project."

# Required output
1) Extension command architecture
2) API/auth/storage approach
3) QA checklist and failure handling
4) Store publication readiness report

About this resource

Knowledge Freshness

This capability pack is pinned to documentation verified on 2026-04-10. When upstream docs change, refresh endpoint contracts, examples, and constraints before using this skill for production changes.

Retrieval Sources

Always prefer direct retrieval from official docs/API references over model memory for limits, endpoint signatures, and behavior guarantees.

Core Workflow

  1. Confirm target version/runtime and pull latest official docs for the task scope.
  2. Build an execution plan with explicit read-only discovery before any mutation.
  3. Validate contracts, permissions, and safety constraints before applying changes.
  4. Execute with deterministic checkpoints and rollback criteria.
  5. Produce a verification report with evidence, caveats, and next actions.

Overview

This capability pack teaches agents how to design and ship Raycast extensions that are useful in real workflows. It focuses on maintainable architecture and store submission quality.

Capability Scope

  • Command and UX architecture
  • External API integration and auth handling
  • Local state and cache strategy
  • Error/fallback UX patterns
  • Publish and post-release maintenance workflow

Compatibility

Native

  • Claude Code / Claude: native skill usage via SKILL.md.
  • Codex/OpenAI workflows: compatible with Agent Skills-style SKILL.md content as reusable workflow instructions.

Manual Adaptation

  • Gemini CLI: native skill usage via .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md where supported.
  • Cursor: use the generated .cursor/rules/*.mdc adapter for project rules.
  • OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.

Production Rules

  • Keep command scope explicit and focused.
  • Protect API tokens and sensitive user data.
  • Design for graceful degradation on API failures.
  • Validate extension behavior on cold and warm starts.

Troubleshooting

Issue: Extension feels slow or brittle
Fix: Add caching and request timeouts with clear fallback UI states.

Issue: Store review rejects submission
Fix: Audit metadata, permissions, and UX consistency against Raycast guidelines.

Issue: External API changes break commands
Fix: Add schema guards and compatibility adapters for remote responses.

Output Contract

  1. Provide an implementation plan ordered by risk and dependency.
  2. Provide exact production-ready config/commands with no placeholders.
  3. Call out secrets, permissions, and least-privilege requirements.
  4. Include rollback and recovery guidance for each risky step.

Validation Checklist

  • Verify all referenced docs/versions before applying changes.
  • Run regression checks for core user flow and error paths.
  • Confirm observability/logging is enabled for changed components.
  • Confirm security controls (auth, rate limits, input validation) still pass.
  • Record final known limitations and follow-up actions.
#raycast#extensions#developer-tools#publishing#capability-pack

Source citations

Add this badge to your README

Show that Raycast Extension Dev Publish Capability Pack Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/raycast-extension-dev-publish-capability-pack.svg)](https://heyclau.de/entry/skills/raycast-extension-dev-publish-capability-pack)

How it compares

Raycast Extension Dev Publish Capability Pack Skill side by side with 2 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

3 trust signals differ across this comparison (Package trust, Source provenance, Submitter).

Next steps differ across entries — use the actions in the table below to copy install commands and source links per resource.

Field
Raycast logoRaycast Extension Dev Publish Capability Pack Skill

Expert Raycast extension capability skill for command design, extension architecture, testing, and store-ready publication workflows.

Open dossier
Raycast logoRaycast Extension Maintainer Capability Pack Skill

Expert Raycast extension maintainer capability pack for reviewing Raycast command structure, manifest metadata, API usage, store submission checks, and privacy-safe release notes aligned to official Raycast developer docs.

Open dossier
Codex Plugin Creator Capability Pack Skill

Expert Codex plugin capability pack for safe plugin scaffolding, manifest quality, MCP integration, and maintainable distribution.

Open dossier
Next stepsDiffers
Open dossierAPI JSONOpen LLMOpen RaycastOpen sourceNewsletterClaim listing
Open dossierAPI JSONOpen LLMOpen RaycastOpen sourceNewsletterClaim listing
Open dossierAPI JSONOpen LLMOpen sourceNewsletterClaim listing
Trust
Review statusReviewedMaintainer reviewedReviewedMaintainer reviewedReviewedMaintainer reviewed
Package trustDiffersPackage verified2026-04-10Package not verifiedPackage verified2026-04-11
Source provenanceDiffersSource-backedSubmission linkedSource submissionNo submission link
SubmitterDiffers—kiannidev—
Install riskReview firstReview firstLow risk
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
BrandRaycast logoRaycastRaycast logoRaycast—
Categoryskillsskillsskills
Sourcefirst-partysource-backedfirst-party
AuthorJSONboredkiannidevJSONbored
Added2026-04-102026-06-152026-04-11
Platforms
Claude CodeCodexWindsurfGeminiCursorCLIRaycast
Claude CodeCodexWindsurfGeminiCursorCLIRaycast
Claude CodeCodexWindsurfGeminiCursorCLI
Source repo———
Safety notes✓Installs from a downloaded package and may run local commands or scaffold files as part of the workflow; review the package and any generated changes before applying.✓This skill reviews extension behavior; it must not publish store updates or run untrusted extension code without maintainer approval. Extensions can invoke network APIs and local filesystem operations; verify least-privilege scopes before release. Do not embed long-lived API tokens in source; prefer Raycast preferences and secure storage patterns. Third-party dependencies in extensions inherit supply-chain risk; review updates before shipping.✓Scaffolds and validates plugin manifests and may run plugin or build commands; review generated manifests and scripts before installing or executing them.
Privacy notes✓Operates on your local project files and any context you share in the session; review what you expose before sharing — nothing is sent beyond the model unless a step calls an external service.✓Raycast extensions may read clipboard, local files, or user preferences depending on API usage. Network calls can transmit query text, auth tokens, and user identifiers to third-party services. Store release notes should not include internal API keys, employee data, or customer examples. Telemetry or analytics SDKs require explicit disclosure in extension README and store metadata.✓Inputs can include source files, prompts, logs, account metadata, repository details, and operational context that may be sent to the configured AI model. Redact secrets, customer data, private URLs, credentials, and proprietary implementation details before sharing prompts, reports, or generated artifacts.
Prerequisites
  • Raycast extension project setup
  • Product use case and command plan
  • API access for external integrations
  • Local Raycast development environment with the extension repository checked out.
  • Access to extension source, package.json, manifest, and command entry points.
  • Raycast CLI or store submission credentials for the maintainer account when publishing.
  • Ability to run extension tests or manual command checks before release.
  • Plugin use case and scope
  • Manifest and MCP requirements
  • Deployment target constraints
Install
curl -L https://heyclau.de/downloads/skills/raycast-extension-dev-publish-capability-pack.zip -o raycast-extension-dev-publish-capability-pack.zip && unzip -o raycast-extension-dev-publish-capability-pack.zip -d ./raycast-extension-dev-publish-capability-pack
—
curl -L https://heyclau.de/downloads/skills/codex-plugin-creator-capability-pack.zip -o codex-plugin-creator-capability-pack.zip && unzip -o codex-plugin-creator-capability-pack.zip -d ./codex-plugin-creator-capability-pack
Config———
Citations
ClaimUnclaimedUnclaimedUnclaimed
Open 3 picks in the interactive comparison tool

Related guides

Source-backed guides for putting this to work.

guides

Adding Plugin Install Hints to Developer CLIs

Write a claude-code-hint tag to stderr under CLAUDECODE, and Claude Code prompts users once to install your official-marketplace plugin.

Review firstSource-backedReview firstAdded 1mo ago
Safety ✓ Privacy ✓by JPette1783
guides

Agent Skills in Claude Agent SDK Applications

Use Agent Skills in the Claude Agent SDK: filesystem discovery via settingSources, the skills option to enable or filter, and tool access.

Review firstSource-backedReview firstAdded 1mo ago
Safety ✓ Privacy ✓by JPette1783
guides

Building In-Process MCP Tools with the Claude Agent SDK

Define in-process MCP tools for the Claude Agent SDK with createSdkMcpServer and the tool helper, then wire them into query.

Review firstSource-backedReview firstAdded 1mo ago
Safety ✓ Privacy ✓by JPette1783

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.