Files
skillshare/website/docs/learn/with-codex.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00

61 lines
1.3 KiB
Markdown

---
sidebar_position: 3
---
# Using skillshare with Codex
> From install to first sync — 5 minutes.
## Prerequisites
- [OpenAI Codex CLI](https://github.com/openai/codex) installed and working
- macOS, Linux, or Windows
## Step 1: Install skillshare
```bash
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
```
## Step 2: Initialize
```bash
skillshare init
```
This detects Codex's skill directory (`~/.codex/skills/`) and adds it as a target automatically.
## Step 3: Install Your First Skill
```bash
skillshare install runkids/my-skills
```
## Step 4: Sync
```bash
skillshare sync
```
Skills are symlinked to `~/.codex/skills/`.
## Step 5: Verify
```bash
ls ~/.codex/skills/
```
You should see your installed skill symlinked.
## Codex-Specific Notes
- **Skill path**: `~/.codex/skills/` (global) or `.agents/skills/` (project)
- **Description limit**: Codex has a 1024-character limit on skill descriptions. Keep the `description` field in `SKILL.md` frontmatter concise
- **Project mode**: Run `skillshare init -p` to manage project-level Codex skills
## What's Next?
- [Manage multiple skills →](/docs/how-to/daily-tasks/organizing-skills)
- [Share with your team →](/docs/how-to/sharing/organization-sharing)
- [Explore more skills →](/docs/reference/commands/search)