Skip to content

README.md

Latest commit

 

History

History
116 lines (82 loc) · 3.11 KB

README.md

File metadata and controls

116 lines (82 loc) · 3.11 KB

My day-to-day development skills

Reusable agent skills published by Zhaoyang Jia.

This repository is structured to work with the open skills installer ecosystem, so you can install skills directly from GitHub with npx skills add.

Available Skills

  • go-workspace-skills: Manage configurable multi-repo Go workspaces from a workspace config file.

Install

# List skills in this repository
npx skills add itamaker/skills --list

# Install go-workspace-skills
npx skills add itamaker/skills --skill go-workspace-skills

Install to specific agents

# Install only to Codex and Claude Code
npx skills add itamaker/skills --skill go-workspace-skills -a codex -a claude-code

Global install

# Install globally without prompts
npx skills add itamaker/skills --skill go-workspace-skills -g -y

Repository Layout

The skills CLI automatically discovers skills from the skills/ directory in this repository:

skills/
  go-workspace-skills/
    SKILL.md
    agents/
    assets/
    references/
    scripts/

The repository also includes .claude-plugin/marketplace.json so the same skill layout is compatible with Claude Code plugin-manifest discovery.

Configuring go-workspace-skills

go-workspace-skills is intentionally generic. Repository lists are not hardcoded into the skill. Each workspace provides its own config file.

Lookup order:

  1. --config /path/to/file.json
  2. GO_WORKSPACE_SKILLS_CONFIG=/path/to/file.json
  3. <workspace-root>/.go-workspace.json
  4. <workspace-root>/go-workspace.json

Bootstrap a workspace config

You can either:

  1. Copy workspace.example.json into your workspace as .go-workspace.json
  2. Or run the bundled script from a checkout of this repository:
python3 skills/go-workspace-skills/scripts/workspace.py --root /path/to/workspace init-config

Then edit the generated config to match your repositories:

{
  "repos": [
    {
      "name": "example-cli",
      "url": "https://github.com/example/example-cli.git",
      "go_project": true
    },
    {
      "name": "docs-site",
      "url": "git@github.com:example/docs-site.git",
      "go_project": false
    }
  ]
}

What the skill does

  • sync [repo...]: clone or fast-forward pull all configured repositories, or a named subset
  • build: run go build ./... across configured Go projects
  • test: run go test ./... across configured Go projects
  • clean --force: delete configured repository directories
  • init-config: write a starter config file

Usage Examples

After installation, ask your coding agent things like:

  • Use $go-workspace-skills to sync all repos in this workspace.
  • Use $go-workspace-skills to pull only skillforge and runlens.
  • Use $go-workspace-skills to build the workspace.
  • Use $go-workspace-skills to run workspace tests.
  • Use $go-workspace-skills to create a workspace config for this repo set.

Future Skills

This repository is meant to hold multiple skills over time. Add new skills under skills/<skill-name>/.

License

MIT