Skip to content

Distribution

Nick Hamze edited this page Jun 3, 2026 · 11 revisions

Distribution

The best install path is not always the best discovery path. Installation should stay simple; distribution is where the directory listings, marketplace notes, and package experiments can live without turning the README into a receipt drawer.

Current Public Paths

  • Codex $skill-installer: fastest setup from inside Codex.
  • GitHub CLI skill install: best terminal path for pinned installs, e.g. gh skill install RegionallyFamous/youish youish --agent codex --scope user --pin v0.3.13.
  • Codex plugin marketplace source: repo-backed plugin source via codex plugin marketplace add RegionallyFamous/youish --ref v0.3.13, then codex plugin add youish@youish.
  • Open skills CLI: broader skill-ecosystem path via npx skills add RegionallyFamous/youish.
  • Release ZIP: youish-skill-v0.3.13.zip is attached to the GitHub release for upload-style skill surfaces.
  • Terminal installer: release-pinned by default, inspectable, no sudo, optional archive SHA verification, and useful when $skill-installer is unavailable.
  • Plugin ZIP: youish-plugin-v0.3.13.zip is attached to the GitHub release for plugin packaging experiments and future plugin distribution paths.
  • Immutable GitHub releases: enabled for the repo so published release assets cannot be silently replaced.

Directory Status

Point-in-time status checked on June 3, 2026. Re-check before citing this table in release notes, docs, or public posts because third-party directories move around.

Directory Status Notes
agentskill.sh Needs recheck Confirm whether the new RegionallyFamous / youish listing appears after the rename.
skills.re Needs recheck Resubmit or confirm skills.re/skills/RegionallyFamous/youish/youish.
Skillstore Needs recheck Confirm whether the accepted pre-rename submission needs a new Youish submission.
AwesomeSkills.dev Manual captcha required The form accepts the GitHub URL, but Cloudflare Turnstile keeps the final submit disabled until a human solves it.
SkillsMD Submitter email required The site has a submit modal, but it asks for an email address.
OmniSkill Blocked by site API The submit API returned a 403 restricted-network response.
OpenAgentSkill Blocked for now The submit form requires at least 3 GitHub stars.
GitHub skill search Preview works; search still sparse gh skill preview RegionallyFamous/youish youish@v0.3.13 works. gh skill search youish --owner RegionallyFamous returned no rows on June 3, 2026.
skills.sh Direct page works; search API still sparse The direct page returns HTTP 200. https://skills.sh/api/search?q=youish returned zero skills on June 3, 2026.

Skills.sh Listing

The live skill page is skills.sh/regionallyfamous/youish/youish. The repo controls the source files and metadata it can publish; Skills.sh controls its index, cache, install telemetry, topic graph, preview rendering, and partner audits.

Listing Field Youish Value Source
Breadcrumb skills / regionallyfamous / youish / youish Skills.sh generates this from the owner, repo, and skill slug.
Name youish SKILL.md frontmatter.
Topic chips Writing, editing, copywriting, marketing, agent workflows Skills.sh-generated. The repo carries matching signals in SKILL.md and metadata.json.
Installation npx skills add https://github.com/RegionallyFamous/youish --skill youish Skills.sh-generated from the repo and skill slug; mirrored in metadata.json.
Summary Sharp, concise rewriting for messy drafts, notes, emails, posts, captions, docs, and reusable voice profiles. Prepared in README.md and metadata.json; Skills.sh may derive, cache, or omit a summary.
Summary bullets Better writing first, concision second, voice preservation inside that standard; no invented facts or bloat; validation-backed anti-generic behavior. Prepared in metadata.json for catalog/reviewer use.
SKILL.md preview Better-writing/concision/voice hierarchy, defaults, intake, modes, quality gates, anti-generic rules, output rules, and validation hooks. SKILL.md; direct page preview was not rendering SKILL.md content on June 3, 2026.
Related skills Generated from indexed topic overlap Skills.sh catalog.
Installs Generated from anonymous skills CLI install telemetry Skills.sh telemetry.
Repository regionallyfamous/youish GitHub source.
GitHub Stars Generated from GitHub when available GitHub metadata.
First Seen Generated when Skills.sh first indexes or receives install telemetry Skills.sh index.
Security Audits Gen Agent Trust Hub, Socket, and Snyk when available Skills.sh partner audits.
Repo grouping Writing & Editing skills.sh.json.
Agents Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Antigravity Discovery notes in metadata.json; Skills.sh owns displayed agent filtering.

Plugin Direction

OpenAI currently frames skills as the authoring format and plugins as the reusable distribution unit for Codex workflows. Self-serve public plugin directory publishing is not available yet, so Youish ships checked plugin ZIPs, a repo marketplace file at .agents/plugins/marketplace.json, a root plugin manifest at .codex-plugin/plugin.json, and a one-command release builder while the public distribution path matures.

For release builds:

python3 scripts/build_release_assets.py --version 0.3.13
python3 scripts/check_release_assets.py dist/release-v0.3.13 --version 0.3.13

Reference Links

Clone this wiki locally