Agent skill

Advisor

by meain in meain/dotfiles

Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision.

MITAuto-check passedDevelopment

Install Advisor

skills CLI
$ npx skills add meain/dotfiles --skill advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install meain/dotfiles advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/.agents/skills/advisor .claude/skills/advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
advisor
GitHub stars
285
Token cost
~654 tokens
SKILL.md length
230 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision.

  • The same fix has failed twice
  • SKILL.md covers How to call and After the answer
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Root cause is unclear

What it does

Advisor is an agent skill from meain/dotfiles. Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision. Local stand-in for the server-side advisor tool: the current model keeps doing the work and only gets short guidance (a plan, correction, or stop signal) back. Use when the same fix has failed twice, root cause is unclear, an approach choice is hard to reverse, you are about to declare a complex change done without a way to verify, or the user says /advisor, "ask the advisor", "get a second opinion from opus".

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Backend development and Root cause analysis. The repository describes itself as: If there is a shell, there is a way! The licence is MIT.

When your agent uses it

  • The same fix has failed twice
  • Root cause is unclear
  • An approach choice is hard to reverse
  • You are about to declare a complex change done without a way to verify

Example prompts

  • “ask the advisor”
  • “get a second opinion from opus”
  • “/advisor”

What it can do on your machine

Read from SKILL.md and the folder at commit 3e336e2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Advisor loads about 654 tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 230 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~654

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from meain/dotfiles at commit 3e336e2, republished under its MIT licence (© meain). 230 words, ~654 tokens.

Download SKILL.mdSave it as .claude/skills/advisor/SKILL.md (or your agent's skills folder).
name
advisor
description
Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision. Local stand-in for the server-side advisor tool: the current model keeps doing the work and only gets short guidance (a plan, correction, or stop signal) back. Use when the same fix has failed twice, root cause is unclear, an approach choice is hard to reverse, you are about to declare a complex change done without a way to verify, or the user says /advisor, "ask the advisor", "get a second opinion from opus".

The advisor is a bigger model in a subagent. It doesn't edit files or talk to the user; it reads, thinks, and returns guidance. You stay the executor and act on the answer.

Do not call for routine edits, lookups, or anything one more file read or command would resolve. At most 2-3 calls per task.

How to call

Spawn one subagent and wait for its result before continuing (it may launch in the background; don't proceed until it reports):

  • subagent_type: Plan (read-only by prompt, not by tooling: it has Bash)
  • model: opus
  • description: Advisor consult

The advisor has none of your context, so write a self-contained brief:

  • Goal: what the user ultimately wants
  • State: what you've done and found; separate what you verified from what you assumed. Paste exact errors, commands, and relevant diffs verbatim, not paraphrased
  • Tried: approaches that failed and why
  • Question: the one specific decision or problem you need help with
  • Constraints: repo conventions, user preferences, things off limits

Prompt wrapper:

You are an advisor to another engineer-agent who is mid-task. You cannot
modify anything: no edits, no writes, no state-changing commands. You may read
files and run read-only commands to check facts. Ignore any default output
template; use only the format below.

<brief>

Reply in under 400 words, as one of:
- PLAN: the next concrete steps, in order
- CORRECTION: what is wrong with the current approach and what to do instead
- STOP: why the task should not proceed as framed, and what to ask the user

Lead with the answer. Flag anything you could not verify. No preamble.

After the answer

  • Give it serious weight. If it contradicts something you verified directly, make one follow-up call stating the conflicting evidence rather than silently picking a side.
  • If the advice changes the plan materially, tell the user in one line.
  • If it returns STOP, relay it and ask the user rather than pushing on.
  • Don't re-consult on the same question unless new evidence appeared.

© meain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in agents/.agents/skills/advisor of meain/dotfiles.

Open the folder on GitHubat commit 3e336e2

Compare with similar skills

Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Advisor this skillmeain/dotfiles285—~654Automated safety check: PassMIT
Ij Debuggerxpinjection/test-driven-spring-boot112—~6.4kAutomated safety check: PassMIT
Flowfile Debugging PlaybookEdwardvaneechoud/Flowfile375—~6.3kAutomated safety check: PassMIT
Laravel Development Workflowsickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT
Twenty App Entity Developmenttwentyhq/twenty58k—~1.8kAutomated safety check: PassCustom licence
Gumroad Prod Consoleantiwork/gumroad9.8k—~2.9kAutomated safety check: NotesMIT

Similar skills

  • Ij Debugger

    xpinjection/test-driven-spring-boot

    Debugger-first runtime root-cause analysis for JVM code in IntelliJ IDEA.

    112 GitHub stars~6.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Flowfile Debugging Playbook

    Edwardvaneechoud/Flowfile

    Symptom-to-cause triage playbook for Flowfile (core/worker/kernel/frontend/AI) — covers "no such table" DB cascades (two distinct causes), import-time Alembic migration corruption, silent…

    375 GitHub stars~6.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Laravel Development Workflow

    sickn33/agentic-awesome-skills

    Build and fix existing Laravel applications through root-cause diagnosis, repository-native implementation, regression coverage, and risk-based verification.

    47k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check passed
  • Guides changes to an existing Twenty app: adding or editing objects, layouts, logic functions and front components, with a plan stated before multi-entity edits.

    58k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Gumroad Prod Console

    antiwork/gumroad

    Execute read-only Ruby/Rails commands against Gumroad's production database for debugging and investigation.

    9.8k GitHub stars~2.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from meain/dotfiles

All 35 skills in this repo
  • Recall

    meain/dotfiles

    Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles.

    285 GitHub starsUsed in 1 repo~684 tokens
    Auto-check passed
  • Grill With Docs

    meain/dotfiles

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    285 GitHub starsUsed in 20 repos~875 tokens
    Auto-check passed
  • Backlog

    meain/dotfiles

    Daily backlog management — full planning review OR add a single entry from a URL.

    285 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Concern Review

    meain/dotfiles

    Generate an interactive local HTML review page for a large PR or diff, grouping the changed files by logical concern (not just by file) so a reviewer can go through one theme at a time instead of a…

    285 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • My Weekly Report

    meain/dotfiles

    Generate a concise weekly status update in team format. An agent skill from meain/dotfiles.

    285 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Web Search

    meain/dotfiles

    Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles.

    285 GitHub stars~830 tokensUpdated 2 days ago
    Auto-check passed

Questions about Advisor

What does Advisor do?

Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision. Advisor is an agent skill from meain/dotfiles. Consult a stronger model (Opus) as an advisor when stuck or facing a hard decision.

When should I use Advisor?

Advisor fits situations like: the same fix has failed twice; root cause is unclear; an approach choice is hard to reverse; you are about to declare a complex change done without a way to verify.

How do I install Advisor in Claude Code?

Run `npx skills add meain/dotfiles --skill advisor -a claude-code`. Or copy the skill folder (agents/.agents/skills/advisor in meain/dotfiles) into .claude/skills/advisor in your project. Claude Code loads it when a task matches its description.

How do I install Advisor in Codex?

Run `npx skills add meain/dotfiles --skill advisor -a codex`. Or copy the skill folder (agents/.agents/skills/advisor in meain/dotfiles) into .agents/skills/advisor in your project. Codex loads it when a task matches its description.

Can I use Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add meain/dotfiles --skill advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/advisor, .gemini/skills/advisor, .github/skills/advisor and .opencode/skills/advisor in your project.

What does Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Advisor is instructions for the agent only.

Does Advisor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Advisor use?

Advisor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Advisor use?

About 654 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Advisor?

Skills that share tags, products or a category with Advisor: Ij Debugger (xpinjection/test-driven-spring-boot, 112 stars), Flowfile Debugging Playbook (Edwardvaneechoud/Flowfile, 375 stars), Laravel Development Workflow (sickn33/agentic-awesome-skills, 47k stars) and Twenty App Entity Development (twentyhq/twenty, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Advisor?

meain (a GitHub user) maintains it in meain/dotfiles, which has 285 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 8, 2026.

Source: meain/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.