OpenDirectory

Documentation

Learn how to integrate our open-source agent skills and automation pipelines into your autonomous agents.

Step-by-Step Installation Guide

Our skills are designed to be consumed directly by autonomous AI agents (like Claude Code, OpenCode, Codex, or Gemini CLI). You don't need to be a software engineer to install these!

Native Installation (Claude Code Only)

Users who exclusively use Anthropic's Claude Code can add Open Directory as a native community marketplace directly inside their Claude interface. This allows you to install skills using Claude's built-in plugin system.

1. Add the Open Directory marketplace

/plugin marketplace add Varnan-Tech/opendirectory

2. Install a skill directly

/plugin install [SKILL-NAME]@opendirectory-marketplace

Standard Installation (Other Agents)

For other agents like OpenCode, Hermes, or Codex, we use a convenient npx command to fetch and install skills directly into your AI agent.

1

Install Node.js (Prerequisite)

Before you can run the installation command, your computer needs a program called Node.js. It allows your computer to run the npx command.

  • Go to the official website: nodejs.org
  • Download the version labeled "Recommended For Most Users" (LTS).
  • Open the downloaded file and click "Next" through the standard installation steps (you don't need to change any default settings).

If you already have Node.js installed, you can skip this step entirely.

2

Find Your Skill & Copy the Command

Browse the Open Directory homepage to find the exact skill you want your AI to learn (for example, the blog-cover-image-cli).

On the bottom right of every skill card, you will see a small copy icon. Click it! This will copy the exact magic command you need to your clipboard.

The copied command will look like this:

npx "@opendirectory.dev/skills" install [SKILL-NAME] --target claude
3

Open Your Terminal

You need to paste that command into your computer's "Terminal" or "Command Prompt".

  • Mac users: Press Cmd + Space, type "Terminal", and hit Enter.
  • Windows users: Press the Windows key, type "cmd" or "Command Prompt", and hit Enter.
4

Paste & Press Enter

Once the black terminal window is open, simply paste the command you copied in Step 2. (On Windows, you can usually just right-click to paste).

Press Enter. You will see some text scrolling by as your computer reaches out to Open Directory and securely downloads the skill directly into your AI agent.

Success!

Once the text stops, the installation is complete. You can close the terminal window. Your AI agent now possesses the new skill and is ready to work!

Advanced: Selecting Your AI Target (npx only)

By default, the copied npx command targets OpenCode. If you are using a different AI agent, you can manually change the --target flag at the end of the command before pressing Enter.

OpenCode

--target opencode

Codex

--target codex

Gemini CLI

--target gemini

Anti-Gravity

--target antigravity

How it works under the hood

When you run our npx command, the tool acts as a bridge between the open-source GitHub repository and your local AI environment. Here is exactly what happens in the background:

  1. Registry Lookup: The CLI fetches the latest skill package definition from the Open Directory manifest.
  2. Secure Download: It downloads the prompt instructions, tool definitions (if any), and system guidelines associated with the skill.
  3. Target Injection: Depending on the --target flag you provided, it writes these definitions into your specific agent's local configuration file (e.g., .claude.json or your global MCP config).
  4. Context Priming: The skill is now "memorized" by your AI. The next time you open your agent, it automatically knows the exact steps, prompts, and APIs needed to execute the skill flawlessly.

Frequently Asked Questions

Do I need to be a developer to use these?

No! While the tools are used inside a terminal, the installation only requires copying and pasting one single line. The AI agent itself handles all the complex "developer" work for you.

Are these skills free?

Yes, all skills hosted on Open Directory are open-source and free to use under the MIT License.

What if my AI needs a password or API key?

Some advanced skills (like a Reddit scraper) might require an API key. When your AI agent attempts to use the skill, it will naturally pause and ask you: "Please provide your API key to continue." Simply paste it into the chat, and the AI will handle the rest securely.

Can I contribute my own skills?

Absolutely! Open Directory is a community-driven project. You can submit your own skills by opening a Pull Request on our GitHub repository. Check out our Contribution Guidelines for more details.

Which AI agents are supported?

Currently, we support Claude Code natively via the marketplace plugin, as well as OpenCode, Codex, Gemini CLI, and Anti-Gravity via the standard npx installation method.

Troubleshooting

"npx is not recognized as an internal or external command"▼
This error means Node.js is not installed on your computer, or your terminal hasn't recognized it yet. Please go back to Step 1 and download Node.js. If you just installed it, completely close your terminal window and open a new one to refresh it.
My AI agent says it doesn't know the skill▼
Ensure you used the correct --target flag during installation. Also, you must completely restart your AI agent (close the window and reopen it) for it to load the newly installed skill configurations.