Agent skill

Instruction Introspection

by PlamenTSV in PlamenTSV/plamen

Trigger Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents, depth agents

MITAuto-check passed

Install Instruction Introspection

skills CLI
$ npx skills add PlamenTSV/plamen --skill instruction-introspection -a claude-code

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

GitHub CLI
$ gh skill install PlamenTSV/plamen instruction-introspection --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/PlamenTSV/plamen.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/skills/solana/instruction-introspection .claude/skills/instruction-introspection && 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
instruction-introspection
GitHub stars
303
Token cost
~1.2k tokens
SKILL.md length
426 words
Files
1
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Trigger Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents, depth agents

  • Works in 6 steps: Introspection Usage Inventory → Sysvar Address Validation (Wormhole… → Checked Function Usage → …
  • Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents
  • SKILL.md covers 1. Introspection Usage Inventory, 2. Sysvar Address Validation…, 3. Checked Function Usage and 4. Instruction Sequence…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Instruction Introspection is an agent skill from PlamenTSV/plamen. Trigger Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents, depth agents

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

It works with Solana. The repository describes itself as: Autonomous Web3 security audit agent for Claude Code. The licence is MIT.

When your agent uses it

  • Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents

Example prompts

  • “/instruction-introspection”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Introspection Usage Inventory
  2. Sysvar Address Validation (Wormhole Pattern - CRITICAL)
  3. Checked Function Usage
  4. Instruction Sequence Validation
  5. State Change Coverage
  6. Program ID Verification

What it can do on your machine

Read from SKILL.md and the folder at commit 795962b. 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 (its code samples are markdown).

    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

Instruction Introspection loads about 1.2k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 426 words of instructions outside code blocks.

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

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 PlamenTSV/plamen at commit 795962b, republished under its MIT licence (© PlamenTSV). 426 words, ~1,236 tokens.

Download SKILL.mdSave it as .claude/skills/instruction-introspection/SKILL.md (or your agent's skills folder).
name
instruction-introspection
description
Trigger Pattern INSTRUCTION_INTROSPECTION flag detected (load_instruction_at/Sysvar1nstructions) - Inject Into Breadth agents, depth agents

INSTRUCTION_INTROSPECTION Skill

Trigger Pattern: INSTRUCTION_INTROSPECTION flag detected (load_instruction_at/Sysvar1nstructions) Inject Into: Breadth agents, depth agents Finding prefix: [II-N] Rules referenced: S10, S8, R15

For every use of instruction introspection in the Solana program:

1. Introspection Usage Inventory

List all instruction introspection usage:

#LocationFunction UsedPurposeInstructions Sysvar Source
1{file:line}load_instruction_at_checked / load_instruction_at / get_instruction_relative{what it checks}{account source}

2. Sysvar Address Validation (Wormhole Pattern - CRITICAL)

For each Instructions sysvar account:

UsageSysvar SourceAddress Validated?Validation Method
{usage}{account param name}YES/NO{hardcoded check / Anchor constraint / NONE}

Attack pattern (sysvar address spoofing): If Instructions sysvar address is NOT validated, attacker passes a fake account containing crafted "instruction" data. The introspection reads attacker-controlled data instead of real transaction instructions. Defense: require!(sysvar_account.key() == sysvar::instructions::ID) or use Anchor #[account(address = sysvar::instructions::ID)].

3. Checked Function Usage

For each load_instruction_at* call:

CallUses _checked Variant?Risk if Unchecked
{call}YES/NO{if NO: deprecated function, potential ABI issues}

Rule: Always use load_instruction_at_checked (validates the sysvar account) over the deprecated load_instruction_at (does not validate).

4. Instruction Sequence Validation

For flash loan and atomic operation patterns:

PatternBorrow Instruction Checked?Repay Instruction Checked?Gap Between Checks?
Flash loan repay checkYES/NOYES/NO{can attacker insert instructions between borrow and repay?}

Attack (marginfi pattern): Protocol checks that a repay instruction exists in the transaction but doesn't verify that no state-modifying instructions execute BETWEEN the borrow and repay. Attacker inserts exploit instructions in the gap. Defense: Verify the COMPLETE instruction sequence, not just the presence of specific instructions.

Show full SKILL.md (180 more words)Show less

5. State Change Coverage

For each introspection-based check:

CheckState Changes Between Checked InstructionsAll Changes Accounted?Gap?
{check}{list possible state changes}YES/NO{if NO: what's unaccounted}

Pattern: Introspection checks often verify instruction A and instruction B exist, but ignore what happens in between. Any state changes between A and B can be exploited.

6. Program ID Verification

For each instruction inspected via introspection:

Inspected InstructionProgram ID Checked?Expected ProgramSpoofable?
{instruction}YES/NO{expected}{if NO: attacker deploys mimicking program}

Attack: Introspection check verifies an instruction with matching function signature exists, but doesn't verify it belongs to the expected program. Attacker deploys a program with the same instruction signature that does nothing.

Finding Template

markdown
**ID**: [II-N]
**Severity**: [sysvar spoofing = Critical, sequence gap = High, missing program check = Medium]
**Step Execution**: ✓1,2,3,4,5,6 | ✗(reasons) | ?(uncertain)
**Rules Applied**: [S10:✓, S8:✓/✗, R15:✓/✗]
**Location**: program/src/{file}.rs:LineN
**Title**: [Introspection issue] in [instruction] enables [attack]
**Description**: [Specific introspection vulnerability with sequence analysis]
**Impact**: [Flash loan bypass / fake instruction acceptance / state manipulation]

Step Execution Checklist (MANDATORY)

SectionRequiredCompleted?Notes
1. Introspection Usage InventoryYES✓/✗/?For every introspection use
2. Sysvar Address ValidationYES✓/✗/?CRITICAL - sysvar address spoofing
3. Checked Function UsageYES✓/✗/?_checked vs deprecated
4. Instruction Sequence ValidationIF flash loan / atomic pattern✓/✗(N/A)/?Gap between checks
5. State Change CoverageYES✓/✗/?Between checked instructions
6. Program ID VerificationYES✓/✗/?For every inspected instruction

© PlamenTSV, 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/skills/solana/instruction-introspection of PlamenTSV/plamen.

Open the folder on GitHubat commit 795962b

Compare with similar skills

Instruction Introspection 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.

Instruction Introspection compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Instruction Introspection this skillPlamenTSV/plamen303—~1.2kAutomated safety check: PassMIT
Solana Devsolana-foundation/solana-dev-skill574—~3.8kAutomated safety check: PassMIT
Meme Coin Security Auditawarexone/Agentic-Bug-Hunter5.3k1 repos~2.4kAutomated safety check: PassMIT
Swapper Depositswapperfinance/swapper-toolkit852—~1.8kAutomated safety check: PassMIT
PNP Prediction Markets on Solanainternet-court/internet-court-skill6.5k—~7.5kAutomated safety check: NotesMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills362—~5.7kAutomated safety check: PassNone

Similar skills

  • Solana Dev

    solana-foundation/solana-dev-skill

    A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…

    574 GitHub stars~3.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Meme Coin Security Audit

    awarexone/Agentic-Bug-Hunter

    Screens EVM and Solana meme coins for rug pull signs such as hidden mint, honeypot logic and fee tricks, starting with fast kill signals before any code review.

    5.3k GitHub starsUsed in 1 repo~2.4k tokens
    SecurityAuto-check passed
  • Swapper Deposit

    swapperfinance/swapper-toolkit

    Deposit and bridge funds into a wallet or protocol using Swapper Finance.

    852 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • PNP Prediction Markets on Solana

    internet-court/internet-court-skill

    Creates, trades and settles permissionless prediction markets on Solana with any SPL token as collateral, including social-media and custom-oracle markets.

    6.5k GitHub stars~7.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check: notes
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    362 GitHub stars~5.7k tokensUpdated 22 days ago
    Business, Finance & HRAuto-check passed
  • Manifest

    Bonasa-Tech/manifest

    A skill your agent uses when building, debugging, or integrating with the Manifest DEX on Solana, especially for TypeScript SDK usage, transaction construction with ManifestClient, market state…

    158 GitHub stars~478 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from PlamenTSV/plamen

All 87 skills in this repo
  • Audit Prep

    PlamenTSV/plamen

    Prepare Solidity projects for a security audit — test coverage, test quality, NatSpec docs, code hygiene, dependency health, best-practice enforcement, deployment readiness, and project…

    303 GitHub stars~3.7k tokensUpdated 13 days ago
    Auto-check passed
  • Verification Protocol

    PlamenTSV/plamen

    Trigger Pattern Always (used by all verifier agents) - Inject Into security-verifier agents (Phase 5)

    303 GitHub stars~3.5k tokensUpdated 13 days ago
    Auto-check passed
  • Ability Analysis

    PlamenTSV/plamen

    Trigger Pattern Always (Aptos Move) - foundational security check - Inject Into Breadth agents, depth agents

    303 GitHub stars~3.3k tokensUpdated 13 days ago
    Auto-check passed
  • Ability Analysis

    PlamenTSV/plamen

    Trigger Pattern Always (Sui Move) -- foundational security check - Inject Into Breadth agents, depth agents

    303 GitHub stars~3.2k tokensUpdated 13 days ago
    Auto-check passed
  • Account Lifecycle

    PlamenTSV/plamen

    Trigger Pattern ACCOUNTCLOSING flag detected (close/CloseAccount usage) - Inject Into Breadth agents, depth agents

    303 GitHub stars~1.2k tokensUpdated 13 days ago
    Auto-check passed
  • Account Validation

    PlamenTSV/plamen

    Trigger Pattern Always required for Solana audits - Inject Into Breadth agents, depth agents

    303 GitHub stars~1.7k tokensUpdated 13 days ago
    Auto-check passed

Works with

Questions about Instruction Introspection

What does Instruction Introspection do?

Trigger Pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents, depth agents. Instruction Introspection is an agent skill from PlamenTSV/plamen.

When should I use Instruction Introspection?

Instruction Introspection fits situations like: pattern INSTRUCTIONINTROSPECTION flag detected (loadinstructionat/Sysvar1nstructions) - Inject Into Breadth agents.

How do I install Instruction Introspection in Claude Code?

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

How do I install Instruction Introspection in Codex?

Run `npx skills add PlamenTSV/plamen --skill instruction-introspection -a codex`. Or copy the skill folder (agents/skills/solana/instruction-introspection in PlamenTSV/plamen) into .agents/skills/instruction-introspection in your project. Codex loads it when a task matches its description.

Can I use Instruction Introspection 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 PlamenTSV/plamen --skill instruction-introspection -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/instruction-introspection, .gemini/skills/instruction-introspection, .github/skills/instruction-introspection and .opencode/skills/instruction-introspection in your project.

What does Instruction Introspection need to run?

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

Does Instruction Introspection 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 Instruction Introspection 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 Instruction Introspection use?

Instruction Introspection 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 Instruction Introspection use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Instruction Introspection?

Skills that share tags, products or a category with Instruction Introspection: Solana Dev (solana-foundation/solana-dev-skill, 574 stars), Meme Coin Security Audit (awarexone/Agentic-Bug-Hunter, 5.3k stars), Swapper Deposit (swapperfinance/swapper-toolkit, 852 stars) and PNP Prediction Markets on Solana (internet-court/internet-court-skill, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Instruction Introspection?

PlamenTSV (a GitHub user) maintains it in PlamenTSV/plamen, which has 303 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on September 26, 2026.

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