Skip to content
Skills Library
AI & agents · Automation

apd-toggle

/apd-toggle

Toggle claude-apd@zstevovich-plugins enabled state in CC settings without leaving the session. Use when the user asks to disable APD, turn it off, enable it, switch APD on/off, or hit a guard block they want to bypass intentionally for non-APD work. Defaults to flipping current state; explicit on/off arg sets directly. Smart-detection picks the right settings file (settings.local.json → settings.json → ~/.claude/settings.json) so the toggle actually affects what CC sees. After the JSON edit, runs /reload-plugins to apply in the active session.

Repository
claude-apd ↗
Licence
MIT
Last repository change
11.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 11.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Toggle claude-apd@zstevovich-plugins enabled state in CC settings without leaving the session. Use when the user asks to disable APD, turn it off, enable it, switch APD on/off, or hit a guard block they want to bypass intentionally for non-APD work. Defaults to flipping current state; explicit on/off arg sets directly. Smart-detection picks the right settings file (settings.local.json → settings.json → ~/.claude/settings.json) so the toggle actually affects what CC sees. After the JSON edit, runs /reload-plugins to apply in the active session.

Original author description

Toggle claude-apd@zstevovich-plugins enabled state in CC settings without leaving the session. Use when the user asks to disable APD, turn it off, enable it, switch APD on/off, or hit a guard block they want to bypass intentionally for non-APD work. Defaults to flipping current state; explicit on/off arg sets directly. Smart-detection picks the right settings file (settings.local.json → settings.json → ~/.claude/settings.json) so the toggle actually affects what CC sees. After the JSON edit, runs /reload-plugins to apply in the active session.

How it works

  1. When to use
  2. When NOT to use
  3. Process
  4. Anti-patterns
  5. Exit criteria
Original SKILL.md headings · 79 lines, 613 words
SKILL.md preview
---
name: apd-toggle
description: Toggle claude-apd@zstevovich-plugins enabled state in CC settings without leaving the session. Use when the user asks to disable APD, turn it off, enable it, switch APD on/off, or hit a guard block they want to bypass intentionally for non-APD work. Defaults to flipping current state; explicit on/off arg sets directly. Smart-detection picks the right settings file (settings.local.json → settings.json → ~/.claude/settings.json) so the toggle actually affects what CC sees. After the JSON edit, runs /reload-plugins to apply in the active session.
effort: low
allowed-tools: Bash SlashCommand
---

# APD Toggle

Quick switch for the claude-apd plugin's `enabledPlugins` state in CC settings. CC-only — Codex has no equivalent concept.

## When to use

- User asks: "turn off APD", "iskljuci APD", "disable apd", "enable apd", "switch APD off", "ugasi APD u ovoj sesiji", "vrati APD nazad", or any phrasing requesting plugin toggle.
- User wants to do quick non-APD work in a project that has APD enabled, without leaving the session.
- User wants to enable APD in a project where it's currently off.
- User asks "kako da ugasim APD" — answer with this skill, not with manual JSON edit instructions.

## When NOT to use

- **To get an out-of-scope fix past a cycle cap or a gate mid-pipeline.** `toggle off`
  disables the WHOLE enforcement layer, so the fix lands with no fresh adversarial pass —
  and it is usually a finding on exactly the paths that most need one. Since v6.29 the
  toggle refuses this: with `APD_ACTIVE` and a `spec-card.md` present it exits 2 with
  `toggle-off-active-pipeline`. The sanctioned routes, in order:
  - out of scope → `apd pipeline spinoff-finding <id> "<reason>"`, then continue in scope
  - genuinely in scope, out of cycles → `apd pipeline raise-cap builder|reviewer <N> "<reason>"`
  - done with the run → `apd pipeline reset`
  `--force "<reason>"` exists as a valve for a real emergency and logs `toggle-off-forced`;
  reaching for it routinely means the run should have been reset or the finding spun off.
- User wants to UNINSTALL the plugin entirely (use `/plugin uninstall` directly — different operation).
- User is on Codex — no `enabledPlugins` concept exists, this skill does nothing useful there.
- User wants to disable a different plugin (e.g. superpowers) — this skill is APD-specific.

## Process

### Step 1 — Parse intent

User intent → flag:

| User said | Flag |
|---|---|
| "turn off", "disable", "iskljuci", "ugasi" | `off` |
| "turn on", "enable", "ukljuci", "vrati" | `on` |
| "toggle", "flip", "switch", or unspecified | (no arg — flip current state) |

If user mentioned `--global` / `globalno` / "user-wide", append `--global`. Same for `--project` (tracked) and `--local` (gitignored). Default is smart-detection (no flag).

### Step 2 — Run the toggle

```bash
bash .claude/bin/apd toggle [on|off] [--global|--project|--local]
```

The script prints:
- Old value → new value
- Which settings file was edited
- Detection rationale (smart-detection note, if applied)

### Step 3 — Reload plugins in-session

After the JSON edit succeeds, invoke `/reload-plugins` via the SlashCommand tool. This applies the change without requiring CC restart.

If the user explicitly asked you NOT to reload (e.g., "edit but don't reload"), skip this step and tell them to run `/reload-plugins` manually when ready.

### Step 4 — Report

One concise line confirming the new state. If toggled OFF, mention briefly that pipeline gates / guards / skills are now inert until re-enabled.

## Anti-patterns

| Don't | Do |
|---|---|
| Manually edit settings.json with Edit/Write tool | Always go through `apd toggle` — it handles smart-detection, file creation, JSON safety via jq |
| Toggle and forget to reload | Always run `/reload-plugins` after the edit unless user explicitly opted out |
| Assume settings.local.json is the only place — write blindly | Trust the script's smart-detection; it knows where the active value lives |
| Report success without showing the new state | Always include the old → new transition + which file was edited |

## Exit criteria

- The toggle script ran successfully (exit 0).
- The user knows the new state (on/off).
- The user knows which file was edited (settings.local.json is most common).
- `/reload-plugins` was invoked (unless user opted out).

Versions

The database has no other skills named apd-toggle.

Database snapshot: 13.11.2026 · package version 30642e1c4153 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100apd-setup
    Use when setting up APD in a new project for the first time or maintaining an existing APD-enabled project — generates CLAUDE.md, per-agent .md files, rules, memory, verify-all.sh, and runs gap analysis to fix missing pieces. Triggers on "setup APD", "init APD", "scaffold APD",…
  • 100apd-audit
    Use when verifying that APD is correctly configured in the current project — qualitative deep audit of agents, hooks, CLAUDE.md, pipeline state, MCP wiring, and guardrails. Goes further than verify-apd. Triggers on "audit APD", "review setup", "is APD configured", "verify…
  • 95skill-toggle
    Enable, disable, and manage Claude Code skills. Use when the user asks to enable/disable/toggle/manage skills, check skill status, list skills, manage skill collections, or clean up the skills directory.
  • 100hook
    Enable, disable, and manage Claude Code hooks. Use for hook debugging or configuration.
  • 90configure-claude-plugins
    Claude plugins marketplace setup: .claude/settings.json, GitHub Actions, plugin pinning. Use when onboarding to claude-plugins, setting up claude.yml, pinning plugins, or overriding global plugins.
  • 84setup
    Verify the context-guard plugin on this machine: jq, node, whether its mod runs in this session, this session's snapshot freshness, zones.json, and every option's effective value. Seed or repair ~/.claude/context-guard/zones.json from the shipped defaults. Use when: 'set up…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.