Olshansk/agent-skills

agent-skills

[!NOTE] My personal and public agent skills. Olshansky.info

What is this?

• Olshansky's day-to-day agent skills
• Follows the Agent Skills pattern for cross-tool skill distribution
• Inspired by vercel-labs/agent-skills

Table of Contents

• Quickstart
• Available Skills
  • 3rd Party Skills
• Star History
• Demo of cmd-skills-dashboard
• How It Works

Quickstart

npx skills add olshansk/agent-skills

Then ask your agent to run any installed skill:

• "resolve merge conflicts"
• "close the loop on this session"
• "idiot proof the documentation"
• "generate skills dashboard"

[!TIP] Start with cmd-session-commit — it turns every coding session into durable knowledge by extracting patterns, decisions, and gotchas into your AGENTS.md. Future sessions (and future agents) pick up right where you left off.

Available Skills

3rd Party Skills

Install skills from other publishers with npx skills add <publisher>/<repo>.

• garrytan/gstack — browser automation, QA, plan review, deploy workflows, and more
• mattpocock/skills — React and TypeScript patterns
• obra/superpowers — miscellaneous productivity skills

Star History

Demo of cmd-skills-dashboard

A live dashboard of the skills.sh ecosystem is available at skills-dashboard.olshansky.info.

It shows publisher distribution, install counts, top skills, and the long-tail power law of adoption. Regenerate it yourself with the cmd-skills-dashboard skill.

How It Works

Symlink Architecture

Two sources of truth feed into every tool's skills directory:

graph TB
    classDef workspace fill:#d4e6f1,stroke:#2980b9,stroke-width:2px,color:#000
    classDef dotdir fill:#fadbd8,stroke:#e74c3c,stroke-width:2px,color:#000

    subgraph sources["Source of Truth"]
        thirdparty["~/.agents/skills/*<br/>(third-party skills)"]
        repo["~/workspace/agent-skills/<br/>·  skills/*  ·  agents/*  ·<br/>(your skills)"]
    end

    subgraph claude["~/.claude/"]
        direction LR
        claude_skills["skills/*"]
        claude_md["CLAUDE.md"]
    end

    subgraph gemini["~/.gemini/"]
        direction LR
        gemini_skills["antigravity/skills/*"]
        gemini_md["GEMINI.md"]
    end

    subgraph codex["~/.codex/"]
        direction LR
        codex_skills["skills/*"]
        codex_md["AGENTS.md"]
    end

    repo -->|"symlink (wins on conflict)"| claude_skills
    repo -->|"symlink (wins on conflict)"| gemini_skills
    repo -->|"symlink (wins on conflict)"| codex_skills
    repo -->|"AGENTS.md"| claude_md
    repo -->|"AGENTS.md"| codex_md
    repo -->|"MEMORIES.md"| gemini_md

    thirdparty -->|"symlink"| claude_skills
    thirdparty -->|"symlink"| gemini_skills
    thirdparty -->|"symlink"| codex_skills

    class repo workspace
    class thirdparty,claude_skills,claude_md,gemini_skills,gemini_md,codex_skills,codex_md dotdir

Makefile Workflows

graph LR
    classDef default color:#000

    skills["agent-skills/skills/*"]
    agents["agent-skills/agents/"]

    subgraph outbound["Symlink OUT"]
        link["make link-skills"]
    end

    subgraph inbound["Copy IN"]
        sync["make sync"]
    end

    claude_dir["~/.claude/"]
    gemini_dir["~/.gemini/"]
    codex_dir["~/.codex/"]
    snapshots["~/workspace/configs/"]

    skills -->|"skills symlink"| link
    agents -->|"instructions symlink"| link
    link --> claude_dir
    link --> gemini_dir
    link --> codex_dir

    claude_dir -->|"file copy"| sync --> snapshots
    gemini_dir -->|"file copy"| sync
    codex_dir -->|"file copy"| sync

After npx skills add

npx skills add installs third-party skills into ~/.agents/skills/ and creates symlinks in ~/.claude/skills/. Running make link-skills afterward restores your repo skills (which take precedence on name conflicts) and extends third-party skills to Codex and Gemini.