The setup at a glance
| Agent | HowAI personal target | Project target | Explicit selection |
|---|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills | /skill-name |
| Codex | ~/.agents/skills | .agents/skills | Skill picker or $skill-name |
| Cursor | ~/.agents/skills | .agents/skills or .cursor/skills | Skill picker or /skill-name |
These are the recommended targets for this walkthrough, not a complete list of every legacy or managed location. Use the dedicated folder reference to troubleshoot another copy.
Switch agents deliberately
First check whether the destination agent already discovers the folder. When the same package is visible in both environments, you may not need another copy. Preserve the complete folder when moving it; scripts and references can be required by the instructions.
- Check the installed version and target with HowAI CLI list.
- Check the name in SKILL.md instead of assuming it equals the download slug.
- Review dependencies and tool permissions in the destination environment.
- Run a small task and compare the produced files after switching.
Local files and remote agents
A Skill on your laptop is not automatically present in a remote machine. Put a reviewed project copy in the repository or follow the agent's supported sync or deployment workflow. Review licenses before sharing a package with a team.
Choose by the work you need
| Question | Why it matters |
|---|---|
| Does the task need local files? | The working environment needs access to those files. |
| Does it render a video or export a deck? | Check runtimes, browsers and output tools. |
| Does it use a connected service? | Confirm the tool is available and authorized. |
| Is it a repeatable team process? | Keep a reviewed version and test fixture in the project. |
Agent support describes the intended environment. It does not guarantee that every output was reproduced in your setup. Continue with the guide for the agent you will actually run.
FAQ
Codex and Cursor can share HowAI's default directory. Claude Code has a different recommended target; remote sessions need their own setup.
Official references
Reviewed October 18, 2026 · HowAI editorial
Found something unclear? Send feedback