# coding-skills

**Repository Path**: xlvp/coding-skills

## Basic Information

- **Project Name**: coding-skills
- **Description**: coding guidelines skills  for codex & claude code  
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Coding Skills

Reusable coding guideline skills for Codex and Claude Code.

This repository keeps shared and agent-specific skill files in source-controlled directories and provides a setup script to install them into local skill directories.

## Layout

```text
skills/
  xlvp-commit-messages/
    SKILL.md
  xlvp-function-prd/
    SKILL.md
agent/skills/
  xlvp-coding-guidelines/
    SKILL.md
claude/skills/
  xlvp-coding-guidelines/
    SKILL.md
setup.sh
```

- `skills/` contains shared skills installed into both Codex and Claude Code skill directories.
- `agent/skills/` contains Codex-compatible skills.
- `claude/skills/` contains Claude Code-compatible skills.
- Agent-specific skills install after shared skills, so same-named specialized skills can override shared ones.
- `setup.sh` installs shared and agent-specific skills into the expected local skill directories.

## Available Skills

| Skill | Source | Installed to |
|---|---|---|
| `xlvp-commit-messages` | `skills/xlvp-commit-messages/SKILL.md` | Codex and Claude |
| `xlvp-function-prd` | `skills/xlvp-function-prd/SKILL.md` | Codex and Claude |
| `xlvp-coding-guidelines` | `agent/skills/xlvp-coding-guidelines/SKILL.md` | Codex |
| `xlvp-coding-guidelines` | `claude/skills/xlvp-coding-guidelines/SKILL.md` | Claude |

## Install

Preview the install without copying files:

```bash
./setup.sh --dry-run
```

Install into the default local directories:

```bash
./setup.sh
```

Defaults:

```text
Codex:  ${CODEX_HOME:-$HOME/.codex}/skills
Claude: ${CLAUDE_HOME:-$HOME/.claude}/skills
```

Override target directories when needed:

```bash
./setup.sh \
  --codex-skills-dir /path/to/codex/skills \
  --claude-skills-dir /path/to/claude/skills
```

The setup script copies skill directories into the target locations. It may overwrite same-named skill files, but it does not delete unrelated files from the target directories.

## Verify

Run syntax and install checks before relying on the setup script:

```bash
bash -n setup.sh
./setup.sh --dry-run
```

For a full isolated install check:

```bash
tmpdir="$(mktemp -d)"
./setup.sh \
  --codex-skills-dir "$tmpdir/codex/skills" \
  --claude-skills-dir "$tmpdir/claude/skills"
find "$tmpdir" -maxdepth 4 -type f | sort
rm -rf "$tmpdir"
```

## Maintenance

- Keep skill names stable unless the install path must change.
- Keep each `SKILL.md` frontmatter discoverable: `name`, `description`, and relevant trigger terms.
- Prefer semantic edits over broad rewrites when adapting one agent version from another.
- Re-run `./setup.sh --dry-run` after adding or renaming skill directories.