skillsFirst-partyLow risk Safety ✓ Privacy ✓
HeyClaude Skill Submission Factory
Create portable Agent Skills, generate platform adapters, validate package metadata, and prepare PR-first HeyClaude submissions.
by JSONbored·added 2026-04-27·
Claude CodeCodexWindsurfGeminiCursorCLI
HarnessClaude CodeCodexWindsurfGeminiCursorCLI
Level:advancedType:generalVerified:validated
Safety notes
- Downloads and unzips a HeyClaude-maintainer-packaged skill archive into a local folder when using the install command.
- Produces public skill package and submission drafts; review generated files before opening a PR or sharing them.
Privacy notes
- Does not require credentials and should only process public skill requirements, source URLs, and validation notes.
- Do not include private repository names, customer data, tokens, or unpublished operating details in generated skill packages.
Prerequisites
- Skill topic and target user
- Official docs or source URLs
- Validation commands or acceptance criteria
Schema details
- Install type
- package
- Reading time
- 6 min
- Difficulty score
- 68
- Troubleshooting
- Yes
- Breaking changes
- No
Package metadata
- Package verified
- Yes
- SHA-256
- 962d4f06d31e7145603a70a94878853e313e15cd9f9ef70256a9a6c1337f24c4
Skill and platform metadata
- Skill type
- general
- Skill level
- advanced
- Verification
- validated
- Verified at
- 2026-06-02
Retrieval sources
https://heyclau.de/submithttps://developers.openai.com/codex/skillshttps://docs.claude.com/en/docs/claude-code/skillshttps://docs.windsurf.com/windsurf/cascade/skillshttps://docs.cursor.com/en/contexthttps://github.com/google-gemini/gemini-cli/blob/main/docs/cli/custom-commands.md
Tested platforms
ClaudeCodexWindsurfGeminiCursorGeneric AGENTS
| Platform | Support | Install path |
|---|---|---|
| claude-code | Native | .claude/skills/<skill-name>/SKILL.md |
| codex | Native | .agents/skills/<skill-name>/SKILL.md |
| windsurf | Native | .windsurf/skills/<skill-name>/SKILL.md |
| gemini | Native | .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md |
| cursor | Adapter | .cursor/rules/<skill-name>.mdc |
| cli | Manual | AGENTS.md or tool-specific context file |
Full copyable content
# Trigger
"Create a portable Agent Skill and prepare a HeyClaude PR-first submission."
# Required output
1) Valid SKILL.md package
2) Platform compatibility table
3) Cursor adapter draft when applicable
4) Single-entry HeyClaude PR fields
5) Gate notes for promo, paid, duplicate, or unsupported contentAbout this resource
Knowledge Freshness
This skill is pinned to Agent Skills and HeyClaude PR-first submission behavior verified on 2026-06-02.
Retrieval Sources
- https://heyclau.de/submit
- https://developers.openai.com/codex/skills
- https://docs.claude.com/en/docs/claude-code/skills
- https://docs.windsurf.com/windsurf/cascade/skills
- https://docs.cursor.com/en/context
- https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/custom-commands.md
Core Workflow
- Define the skill user, trigger language, and out-of-scope behavior.
- Create a single root folder with
SKILL.md. - Keep
SKILL.mdconcise, with requirednameanddescriptionfrontmatter. - Add only necessary optional resources under
scripts/,references/,assets/, oragents/openai.yaml. - Generate compatibility notes for native Agent Skills platforms and adapter-only platforms.
- Prepare HeyClaude PR fields from the canonical submit form instead of auto-publishing.
Capability Scope
- Agent Skill package authoring
- Compatibility metadata
- Cursor
.mdcadapter drafting - Package validation checklist
- HeyClaude PR-first submission preparation
Compatibility
Native Agent Skills
- Claude
- Codex/OpenAI
- Windsurf
- Gemini
Adapter Targets
- Cursor via
.cursor/rules/<skill-name>.mdc - Generic AGENTS or tool-specific context files
Production Rules
- Do not claim native support for a platform unless its current docs support
SKILL.md-style skills. - Do not include private repo names, secrets, credentials, or internal operating details in a public skill.
- Do not auto-publish registry content; prepare a maintainer-reviewed single-entry PR submission.
- Keep package resources minimal and directly referenced from
SKILL.md.
Troubleshooting
Issue: The skill is too broad to trigger reliably Fix: Narrow the description to the exact workflow and add negative scope.
Issue: Cursor users ask how to install it Fix: Generate a Cursor rule adapter and label it as an adapter, not a native skill.
Content outline
#heyclaude#skill-authoring#agent-skills#registry#submissions
Source citations
Signals
Loading live community signals…
More like this, weekly
A short, calm digest of reviewed Claude resources. Unsubscribe any time.