Skip to content

docs: fix install snippets across skills pages #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
charlesrhoward merged 1 commit into from
Apr 24, 2026
Merged

docs: fix install snippets across skills pages #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 16 additions & 6 deletions content/docs/cli/skills/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,20 +38,30 @@ The canonical skill files live in the docs repo at `skills/<name>/SKILL.md` and

## Install

The skill files are hosted in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Fetch them first, then copy into your agent host.
The skill files are hosted in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Pick one fetch method (this sets a `SKILLS` path variable), then copy into your agent host.

### Claude Code

```bash
# Fetch just the skills/ tree (no full clone needed)
# Option A — full clone
git clone https://github.com/webrenew/mogplex-docs.git
SKILLS=mogplex-docs/skills

# Option B — sparse download of just the skills/ tree
# degit copies the *contents* of skills/ into mogplex-skills/,
# so mogplex-skills is the skills tree (no nested skills/ dir).
npx -y degit webrenew/mogplex-docs/skills mogplex-skills
cd mogplex-skills
SKILLS=mogplex-skills
```

Then, in the same shell:

```bash
# Global
mkdir -p ~/.claude/skills && cp -R . ~/.claude/skills/
mkdir -p ~/.claude/skills && cp -R "$SKILLS"/* ~/.claude/skills/

# Or per-project (run from your project root, not the downloaded skills dir)
mkdir -p .claude/skills && cp -R /path/to/mogplex-skills/* .claude/skills/
# Or per-project (run from your project root)
mkdir -p .claude/skills && cp -R "$SKILLS"/* .claude/skills/
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Use absolute SKILLS path for per-project copy

The per-project command tells users to run from their project root, but SKILLS is set to a relative path (mogplex-docs/skills or mogplex-skills), so cp -R "$SKILLS"/* .claude/skills/ fails as soon as they cd to a different directory. This makes the documented per-project install path non-functional for the common case where the app repo is separate from the downloaded docs/skills folder (the same pattern appears in content/docs/extend/skills.mdx).

Useful? React with 👍 / 👎.

```

### Claude Agent SDK
Expand Down
20 changes: 11 additions & 9 deletions content/docs/extend/skills.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,26 +44,28 @@ When the MCP server ships, both paths will stay supported. Skills will continue

## Install

First fetch the skill files from [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs). Either clone the repo or download the `skills/` tree directly:
The skills live in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Pick one fetch method, which sets a `SKILLS` path variable used by the copy step below:

```bash
# Option A — clone and cd
# Option A — full clone (gives you the rest of the docs repo too)
git clone https://github.com/webrenew/mogplex-docs.git
cd mogplex-docs
SKILLS=mogplex-docs/skills

# Option B — sparse download of just the skills/ tree
# degit copies the *contents* of skills/ into mogplex-skills/,
# so mogplex-skills is the skills tree (no nested skills/ dir).
npx -y degit webrenew/mogplex-docs/skills mogplex-skills
cd mogplex-skills && cd .. # or rename the dir as you like
SKILLS=mogplex-skills
```

Then copy the `skills/` contents into your agent host:
Then copy into your agent host. Both commands run from the same shell where you set `$SKILLS`:

```bash
# Global (Claude Code) — run from the directory containing `skills/`
mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
# Global (Claude Code)
mkdir -p ~/.claude/skills && cp -R "$SKILLS"/* ~/.claude/skills/

# Or per-project
mkdir -p .claude/skills && cp -R skills/* .claude/skills/
# Or per-project (run from your project root)
mkdir -p .claude/skills && cp -R "$SKILLS"/* .claude/skills/
```

See [CLI → Skills](/cli/skills) for Agent SDK integration, Cursor instructions, and the full install matrix.
Expand Down
4 changes: 4 additions & 0 deletions skills/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ Each subdirectory is a single skill with a `SKILL.md` using standard YAML frontm

## Install into Claude Code

Run from the `mogplex-docs` repo root (the directory that contains this `skills/` folder):

```bash
# Global install
mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
Expand All @@ -28,6 +30,8 @@ mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
mkdir -p .claude/skills && cp -R skills/* .claude/skills/
```

If you pulled the skills tree with `npx degit webrenew/mogplex-docs/skills mogplex-skills` instead (so there is no outer `skills/` directory), run the copy as `cp -R mogplex-skills/* ~/.claude/skills/`.
Copy link
Copy Markdown

@mogplex mogplex Bot Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: skills/README.md degit note only covers the global install path

The new sentence added at the end of the install section reads:

If you pulled the skills tree with npx degit … mogplex-skills instead (so there is no outer skills/ directory), run the copy as cp -R mogplex-skills/* ~/.claude/skills/.

It only shows the global target (~/.claude/skills/). The block directly above it documents both global and per-project install, so a reader who wants per-project install via degit has to mentally substitute the path themselves.

Suggestion — expand the note to cover both variants, matching the structure above it:

If you pulled the skills tree with `npx degit webrenew/mogplex-docs/skills mogplex-skills` instead (so there is no outer `skills/` directory):

```bash
# Global
mkdir -p ~/.claude/skills && cp -R mogplex-skills/* ~/.claude/skills/

# Or per-project (run from your project root)
mkdir -p .claude/skills && cp -R mogplex-skills/* .claude/skills/

This keeps `README.md` fully self-contained for degit users, consistent with how `content/docs/extend/skills.mdx` and `content/docs/cli/skills/index.mdx` handle it.


## Install into an Agent SDK app

```ts
Expand Down