diff --git a/codex-rs/core/src/features.rs b/codex-rs/core/src/features.rs index a011884fc4..0bbebe7388 100644 --- a/codex-rs/core/src/features.rs +++ b/codex-rs/core/src/features.rs @@ -342,8 +342,8 @@ pub const FEATURES: &[FeatureSpec] = &[ FeatureSpec { id: Feature::Skills, key: "skills", - stage: Stage::Experimental, - default_enabled: false, + stage: Stage::Stable, + default_enabled: true, }, FeatureSpec { id: Feature::ShellSnapshot, diff --git a/docs/skills.md b/docs/skills.md index 81bc278797..d380bece60 100644 --- a/docs/skills.md +++ b/docs/skills.md @@ -1,6 +1,4 @@ -# Skills (experimental) - -> **Warning:** This is an experimental and non-stable feature. If you depend on it, please expect breaking changes over the coming weeks and understand that there is currently no guarantee that this works well. Use at your own risk! +# Skills Codex can automatically discover reusable "skills" you keep on disk. A skill is a small bundle with a name, a short description (what it does and when to use it), and an optional body of instructions you can open when needed. Codex injects only the name, description, and file path into the runtime context; the body stays on disk. diff --git a/skills/yeet/SKILL.md b/skills/yeet/SKILL.md new file mode 100644 index 0000000000..8353bcff83 --- /dev/null +++ b/skills/yeet/SKILL.md @@ -0,0 +1,11 @@ +--- +name: yeet +description: Automate branch+PR flow: if not already, create ambrosino/{description} branch, then stage+commit all, push, and open a gh PR with a concise summary. +--- + +# Yeet +- If on main/master/default, `git checkout -b "ambrosino/{description}"`; otherwise stay on the current branch. +- Confirm status `git status -sb`, then stage everything `git add -A`. +- Commit tersely with the description, e.g. `git commit -m "{description}"`. +- Push with tracking: `git push -u origin $(git branch --show-current)`. +- Open a PR: `gh pr create --fill --head $(git branch --show-current)` and edit title/body to reflect the description and the deltas.