@quydoan/myskills

Personal agentskills.io skills collection. Compatible with Claude Code, Cursor, Gemini CLI, Copilot, and any agent supporting the agentskills.io spec.

Install

npx skills add RobDoan/myskills

Or install all tracked skill repos at once using the CLI:

npx @quydoan/myskills install        # project-level (-p)
npx @quydoan/myskills install -g     # global

Add a New Skill

1. Create a directory under skills/ with your skill name:

mkdir skills/my-new-skill

2. Create skills/my-new-skill/SKILL.md with YAML frontmatter:

---
name: my-new-skill
description: What it does and when to use it.
metadata:
  author: quydoan
  version: "1.0"
---

# My New Skill

Instructions for the agent...

3. Validate locally:

npm run validate

Track an Upstream Repo

Add an entry to skill-repos.yml:

repos:
  - name: repo-name
    url: https://github.com/owner/repo
    branch: main
    skills:            # optional: auto-select specific skills during install
      - pr-review
      - commit

When a skills array is present, myskills install passes --skill <names> to npx skills add so you don't have to manually select them each time.

A weekly GitHub Action checks for changes and creates issues with compare links.

To check manually:

GITHUB_TOKEN=your_token GITHUB_REPOSITORY=RobDoan/myskills npm run check-upstream

Development

npm install    # install dependencies
npm test       # run tests
npm run validate        # validate all skills
npm run check-upstream  # check upstream repos (requires GITHUB_TOKEN)

Releases

This project uses semantic-release for automated versioning and publishing. Every push to main triggers a GitHub Actions workflow that:

1. Analyzes commits using Conventional Commits (fix: = patch, feat: = minor, BREAKING CHANGE = major)
2. Publishes to npm
3. Creates a GitHub Release with an auto-generated changelog