mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
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)
61 lines
1.3 KiB
Markdown
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)
|