-
Notifications
You must be signed in to change notification settings - Fork 0
Install
- For the Codex prompt install: Codex with skills support.
- For the terminal installer:
curl,tar, Python 3, and a macOS/Linux shell. - For the open skills CLI: Node/npm through
npx. - For clone, symlink, validation, and local release builds: Git, Python 3, and a shell.
The prompt install is the streamlined path. It does not require cloning the repo first.
This is the normal path. Open Codex and paste:
Use $skill-installer to install Youish from GitHub repo RegionallyFamous/youish. Use path "skills/youish" and install it as "youish".
Then start a new Codex session and use:
Use $youish on this:
[paste draft]
The built-in installer handles the GitHub download and places the skill in the active Codex skills folder for that environment.
Tiny post-install smoke test:
Use $youish on this:
this note is too long and somehow still says nothing. make it clear but keep the tiny bit of attitude.
You should get a cleaned-up rewrite, not setup instructions.
Use this if you prefer Terminal or if $skill-installer is not available:
curl -fsSL https://raw.githubusercontent.com/RegionallyFamous/youish/v0.3.13/install.sh | YOUISH_REF=v0.3.13 bashThe script downloads the tagged GitHub archive, installs a copy into the Codex user skills folder, backs up an existing Youish install if needed, and runs the install verifier. It does not use sudo.
To install from main instead of the release tag:
curl -fsSL https://raw.githubusercontent.com/RegionallyFamous/youish/main/install.sh | YOUISH_REF=main bashIf you want to inspect the script first:
curl -fsSLO https://raw.githubusercontent.com/RegionallyFamous/youish/v0.3.13/install.sh
less install.sh
YOUISH_REF=v0.3.13 bash install.shTo install somewhere custom:
curl -fsSL https://raw.githubusercontent.com/RegionallyFamous/youish/v0.3.13/install.sh | YOUISH_REF=v0.3.13 bash -s -- --install-dir "$HOME/.agents/skills/youish"For a deterministic release-asset install, pull the published skill ZIP and verify it against SHA256SUMS:
curl -fsSL https://raw.githubusercontent.com/RegionallyFamous/youish/v0.3.13/install.sh | YOUISH_REF=v0.3.13 YOUISH_SOURCE=release-zip bashUse this path if you want to edit Youish, run the full test suite, or keep a live symlinked checkout.
git clone https://github.com/RegionallyFamous/youish.git
cd youishThe repo installer defaults to $CODEX_HOME/skills/youish, or ~/.codex/skills/youish when CODEX_HOME is unset. It backs up an existing Youish install, creates a symlink by default, and runs the install verifier.
python3 scripts/install.pySome Codex environments read user skills from ~/.agents/skills. Use an explicit install directory when that is the active folder on your machine:
python3 scripts/install.py --install-dir "$HOME/.agents/skills/youish"Use --copy if you cannot or do not want to symlink. Copy installs include only the installable skill package files.
python3 scripts/install.py --copySymlinks are preferred because they prevent drift. If you use a copy install, rerun the installer after updates so stale package files are replaced cleanly.
mkdir -p ~/.agents/skills
if [ -e ~/.agents/skills/youish ]; then
mv ~/.agents/skills/youish ~/.agents/skills/youish.backup.$(date +%s)
fi
ln -s "$(pwd)" ~/.agents/skills/youishpython3 scripts/check_install.pyExpected result for a symlink install:
Installed skill matches repo (symlink): ...
Expected result for a copy install:
Installed skill matches repo (copy): ...
The $skill-installer prompt above asks for skills/youish, the mirrored runtime package. That gives Codex the SKILL.md, metadata, references, scripts, and assets without requiring a clone.
The terminal installer's copy mode installs a smaller package:
SKILL.mdLICENSEagents/openai.yaml- icon assets
- optional references
- helper scripts for validation, audits, rewrite reports, regression-case scaffolding, voice probing, live reporting, scorecards, and optional live eval
Normal Youish use does not run or load the scripts or references.
GitHub CLI's skill commands are useful when you want an explicit release pin:
gh skill install RegionallyFamous/youish youish --agent codex --scope user --pin v0.3.13To install the newest repo state instead of a tagged release, omit the version:
gh skill install RegionallyFamous/youish youish --agent codex --scope userPinned installs intentionally stay pinned. To check for updates:
gh skill update youish --dry-runUse gh skill update --unpin youish only when you want the install to move to the latest available version.
Youish also ships repo plugin marketplace metadata. This is useful for Codex CLI/plugin users who want the plugin package rather than just the direct skill install.
codex plugin marketplace add RegionallyFamous/youish --ref v0.3.13
codex plugin marketplace list
codex plugin add youish@youishThe youish@youish name means: install the plugin named youish from the marketplace source named youish. The bundled skill becomes available after plugin install.
For skill-aware agents and ecosystems that use the shared skills installer:
npx skills add RegionallyFamous/youishUse this when your environment already speaks the open skills format or when you want Youish discoverable through skills.sh install tracking. For Codex-only use, the Codex prompt install is still the most direct path.
Download youish-skill-v0.3.13.zip from the v0.3.13 release. Use this for skill surfaces that support local ZIP uploads.
Verify the asset:
gh release download v0.3.13 --repo RegionallyFamous/youish --pattern 'youish-skill-v0.3.13.zip' --pattern 'SHA256SUMS'
grep 'youish-skill-v0.3.13.zip' SHA256SUMS | shasum -a 256 -c -python3 scripts/build_release_assets.py --version 0.3.13
python3 scripts/check_release_assets.py dist/release-v0.3.13 --version 0.3.13The release directory contains the skill ZIP, plugin ZIP, public scorecard JSON, and SHA256SUMS. The plugin package contains .codex-plugin/plugin.json, Codex UI metadata, icon assets, and the installable skill under skills/youish/.
Discovery directories, third-party listings, and marketplace notes live on Distribution.