dotskills

Reusable SKILL.md files for AI coding agents — works with Claude Code, Kiro, Cursor, Windsurf, GitHub Copilot, and any agent that supports the SKILL.md open standard.

Each skill is a single SKILL.md folder you drop into your project or home directory. One file, all platforms, no rewriting.

Born from real-world friction: these skills were extracted from production setups after spending hours debugging issues that should have taken minutes. The goal is to save every developer that same time.

---

Why dotskills?

AI coding agents are powerful, but they don't come pre-loaded with knowledge of complex, version-sensitive developer workflows — things like setting up OIDC publishing, configuring trusted CI pipelines, or wiring up platform-specific toolchains correctly. One wrong version or one missing config step and you get a cryptic error with no helpful message.

dotskills is a collection of battle-tested SKILL.md files that teach your AI agent exactly how to handle these tasks — with the exact versions, the exact steps, and the common pitfalls documented upfront.

---

Platform support

All skills use the SKILL.md open standard and work across every major AI coding assistant:

Platform	Project path	Global path
Claude Code	.claude/skills/<name>/SKILL.md	~/.claude/skills/<name>/SKILL.md
Kiro	.kiro/skills/<name>/SKILL.md	~/.kiro/skills/<name>/SKILL.md
Cursor	.cursor/skills/<name>/SKILL.md	~/.cursor/skills/<name>/SKILL.md
Windsurf	.windsurf/skills/<name>/SKILL.md	—
GitHub Copilot	.github/skills/<name>/SKILL.md	~/.copilot/skills/<name>/SKILL.md
Any (cross-platform)	.agents/skills/<name>/SKILL.md	~/.agents/skills/<name>/SKILL.md

Tip: .agents/skills/ is a cross-platform path supported by Cursor, Copilot, and others. Install a skill there once and it works for all of them in that project.

---

Available skills

Skill	Description	Tags
npm-trusted-publishing	Set up OIDC-based npm publishing with no NPM_TOKEN — covers npmjs.com setup and exact CI/CD requirements	ci-cd npm oidc github-actions

---

Install a skill

# Clone dotskills
git clone https://github.com/sagar465/dotskills.git
cd dotskills
chmod +x install.sh

# Install to your AI platform
./install.sh npm-trusted-publishing --platform claude-code --global
./install.sh npm-trusted-publishing --platform kiro
./install.sh npm-trusted-publishing --platform cursor
./install.sh npm-trusted-publishing --platform windsurf
./install.sh npm-trusted-publishing --platform copilot
./install.sh npm-trusted-publishing --platform agents

Manual install (no script)

# Claude Code — global
cp -r skills/npm-trusted-publishing ~/.claude/skills/

# Kiro — project
cp -r skills/npm-trusted-publishing .kiro/skills/

# Cursor — project
cp -r skills/npm-trusted-publishing .cursor/skills/

# Windsurf — project
cp -r skills/npm-trusted-publishing .windsurf/skills/

# GitHub Copilot — project
cp -r skills/npm-trusted-publishing .github/skills/

# Cross-platform — project (Cursor + Copilot)
cp -r skills/npm-trusted-publishing .agents/skills/

List all available skills

./install.sh --list

---

Origin

The first skill in this repo — npm-trusted-publishing — was extracted from the setup process for react-native-soci-auth and react-soci-auth, two open-source React and React Native social authentication libraries. Getting npm OIDC trusted publishing to work required discovering an exact combination of Node version, npm version, setup-node action version, and cache settings that no single doc spelled out clearly. That hard-won knowledge is now this skill.

---

Contributing

Have a workflow that took you too long to figure out? Turn it into a skill.

See CONTRIBUTING.md for the skill template and submission guidelines.

---

Keywords

AI agent skills · SKILL.md · Claude Code · Kiro · Cursor · Windsurf · GitHub Copilot · npm OIDC · trusted publishing · reusable agent prompts · cross-platform AI tools · developer workflow automation