Guide Me

An Agent Skill for learning while implementing.

Guide Me lets agents investigate your codebase and understand the solution, but keeps implementation ownership with you.

The agent can:

• inspect the repository
• research APIs
• explain concepts
• run tests
• inspect your diff
• review your implementation
• debug failures with you

The agent will not write the implementation unless you explicitly leave guide mode.

Install

npx skills add raisiqueira/guide-me-skill

This installs the skill for the coding agents on your machine (Claude Code, Cursor, OpenCode, Codex, and others).

Install globally instead of in the current project:

npx skills add raisiqueira/guide-me-skill -g

Plugin install

The skill lives in skills/guide-me. Plugin manifests at the repository root point each harness at that same skill if you prefer a native plugin install.

Claude Code

/plugin marketplace add raisiqueira/guide-me-skill
/plugin install guide-me@guide-me

Load it without a marketplace:

claude --plugin-dir /path/to/guide-me-skill

Cursor

Symlink or copy this repository into Cursor's local plugins directory, then reload the window:

ln -s /path/to/guide-me-skill ~/.cursor/plugins/local/guide-me

OpenCode

Add the plugin to opencode.json (project or global):

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "guide-me-skill@git+https://github.com/raisiqueira/guide-me-skill.git"
  ]
}

Restart OpenCode. The plugin registers skills/ automatically.

If you clone this repository and run OpenCode inside it, .opencode/plugins/ loads on its own.

Codex

Codex loads this repository through .codex-plugin/plugin.json.

Usage

Invoke the Guide Me skill and describe your task:

Guide me through implementing cancellation for our search requests.

Optional modes:

Guide me through this in challenge mode.

Guide me through this as an advanced TypeScript developer.

Guide me through fixing this failing test, but don't write the code for me.