# Valorvie Custom Skills Custom Skills Dev

> custom-skills-dev

- Skill: `tomevault-io/valorvie-custom-skills-custom-skills-dev` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/valorvie-custom-skills-custom-skills-dev`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/valorvie-custom-skills-custom-skills-dev/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/valorvie-custom-skills-custom-skills-dev

---


# custom-skills-dev

Development guide for the custom-skills project (ai-dev CLI tool).

## Project Overview

This project is a **Configuration as Code** repository providing:
- Unified AI development standards (Skills, Commands, Agents)
- CLI tool (`ai-dev`) for managing AI tool configurations
- Three-stage copy architecture for resource distribution

## Quick Reference

### Key Directories

| Directory | Purpose |
|-----------|---------|
| `script/` | Python CLI implementation |
| `skills/` | Shared skills (all AI tools) |
| `commands/` | Tool-specific commands (claude/, gemini/, etc.) |
| `agents/` | Tool-specific agents (claude/, opencode/) |
| `sources/` | Upstream resource integration (ecc/) |
| `upstream/` | Upstream tracking system |

### Three-Stage Copy Flow

```
Stage 1: Clone     GitHub repos → ~/.config/
Stage 2: Integrate ~/.config/* → ~/.config/custom-skills/
Stage 3: Distribute ~/.config/custom-skills/ → ~/.claude/, ~/.gemini/, etc.
```

For details, see [references/copy-architecture.md](references/copy-architecture.md).

## Common Development Tasks

### Adding a New Skill

1. Create `skills/<skill-name>/SKILL.md`
2. Add optional `references/` for detailed docs
3. Run `ai-dev update` to distribute
4. Update CHANGELOG.md

### Adding a New CLI Command

1. Create `script/commands/<command>.py`
2. Register in `script/main.py`
3. Update README.md command table
4. Update CHANGELOG.md
5. Bump version in `pyproject.toml`

For details, see [references/cli-development.md](references/cli-development.md).

### Releasing a New Version

1. Update version in `pyproject.toml`
2. Add CHANGELOG entry with date
3. Commit: `git commit -m "chore(release): v0.X.Y"`
4. Tag: `git tag v0.X.Y`
5. Push: `git push && git push --tags`

For details, see [references/release-workflow.md](references/release-workflow.md).

### Integrating Upstream Resources

1. Add source to `upstream/sources.yaml`
2. Clone to `~/.config/`
3. Run `/custom-skills-upstream-sync` to analyze
4. Create integration proposal via `/openspec:proposal`
5. Place resources in `sources/<name>/`

## Language Convention

- Documentation: **繁體中文** (Traditional Chinese)
- Technical terms preserved in English: Skill, Command, Agent, Hook, MCP
- Commit messages: 繁體中文 with Conventional Commits format

## Testing Changes

```bash
# Install locally for testing
uv tool install . --force

# Verify installation
ai-dev --version
ai-dev status

# Test specific command
ai-dev install --only state,targets --target claude
```

## References

- [Copy Architecture](references/copy-architecture.md) - Three-stage flow details
- [CLI Development](references/cli-development.md) - Python CLI guide
- [Release Workflow](references/release-workflow.md) - Version release process

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/valorvie) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->