dotagents

Install and sync agent skill dependencies from dotagents configs.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/joshuadavidthomas/wl-zenwindow --skill dotagents-joshuadavidthomas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotagents
Source: https://github.com/joshuadavidthomas/wl-zenwindow/tree/main/.agents/skills/dotagents
Command: npx skills add https://github.com/joshuadavidthomas/wl-zenwindow --skill dotagents-joshuadavidthomas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate and manage agent skill dependencies declared in agents.toml so multiple tools can discover and use them from a centralized skill store like .agents/skills/.

Core Features & Use Cases

  • Resolve, install, and symlink skills from sources (e.g., GitHub) into the local .agents/skills directory.
  • Support wildcard entries to bring in all skills from a source and maintain a lockfile.
  • Synchronize state, repair broken symlinks, and generate per-agent configs for Claude, Cursor, Codex, VS Code, and OpenCode.

Quick Start

Initialize a new project with dotagents by running dotagents init.

Frequently Asked Questions about dotagents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate and install agent skill dependencies across multiple tools?

You can coordinate and install agent skill dependencies by declaring them in an agents.toml file. The tool resolves sources, pins refs, and syncs state across multiple agent tools to guarantee reproducible setups.

What is the best way to manage agent skills from a centralized store?

Managing agent skills from a centralized store involves symlinking resolved skills into a local .agents/skills directory. This allows multiple tools to discover and use them while maintaining a lockfile for reproducibility.

Can I use wildcard entries to install all skills from a source in agents.toml?

Yes, agents.toml supports wildcard entries to bring in all skills from a source. The tool resolves these wildcard entries, pins their refs, and maintains a lockfile to track the synchronized state.

Does dotagents work with Claude, Cursor, and VS Code configurations?

Yes, dotagents synchronizes state and generates per-agent configs for Claude, Cursor, Codex, VS Code, and OpenCode. It writes these configurations to ensure the tools correctly discover the installed skills.

How do I repair broken symlinks for installed agent skills?

To repair broken symlinks for installed agent skills, you can synchronize state using the tool. It repairs broken symlinks and ensures trust where configured, writing a lockfile to guarantee reproducible setups.

Why do I need a lockfile for agent skill dependencies?

A lockfile is needed for agent skill dependencies to guarantee reproducible setups. It pins refs and records the synchronized state of resolved skills, ensuring the same versions are installed across different environments.