---
name: deleting-op-secrets
description: Deletes or archives secrets in 1Password using the op CLI. Use when the user needs to permanently remove items, archive deprecated credentials, or clean up unused secrets from 1Password vaults. Supports both permanent deletion and archiving for later recovery.
disable-model-invocation: true
---

# Overview

This skill enables agents to delete or archive secrets in 1Password using the `op` CLI. It supports permanent deletion for items no longer needed and archiving for items that might need to be recovered later.

The skill assumes the `op` CLI is installed and the user is already authenticated.

# Table of Contents

- [Overview](#overview)
- [Table of Contents](#table-of-contents)
- [Supported Operations](#supported-operations)
- [Workflow](#workflow)
  - [Phase 1: Context Assessment](#phase-1-context-assessment)
  - [Phase 2: Delete Execution](#phase-2-delete-execution)
- [Reference Documentation](#reference-documentation)

# Supported Operations

| Operation | Use Case |
|-----------|----------|
| Delete Item | Permanently remove an item from 1Password |
| Archive Item | Move an item to Archive for potential recovery |

# Workflow

## Phase 1: Context Assessment

### Step 1: Understand the Request

Determine what the user wants to delete or archive:

1. **Identify the target item**:
   - Item name or ID
   - Vault location (if known or ambiguous)

2. **Identify the operation type**:
   - Permanent deletion (item removed completely)
   - Archive (item moved to Archive, recoverable)

3. **Assess the situation**:
   - Is the credential compromised? (permanent delete recommended)
   - Might the item be needed later? (archive recommended)
   - Is this a cleanup of test/duplicate items? (permanent delete)

4. **Clarify if needed**:
   - If item name is ambiguous, ask for vault or use item ID
   - If operation type is unclear, recommend archive as safer option

## Phase 2: Delete Execution

### Step 2: Confirm Deletion

Before executing a destructive operation, confirm with the user:

1. **For permanent deletion**:
   - Warn that this action cannot be undone
   - Confirm the correct item is targeted
   - Suggest archive as alternative if appropriate

2. **For archiving**:
   - Confirm the item will be moved to Archive
   - Explain that archived items can be restored via 1Password app

### Step 3: Execute Delete Command

Based on the context assessment, execute the appropriate `op` command.

See [op CLI Delete Command Reference](references/op-delete-commands.md) for complete command syntax.

**Permanent deletion**:
```bash
op item delete "<item-name>"
```

**Permanent deletion from specific vault**:
```bash
op item delete "<item-name>" --vault "<vault>"
```

**Archive item**:
```bash
op item delete "<item-name>" --archive
```

**Archive from specific vault**:
```bash
op item delete "<item-name>" --vault "<vault>" --archive
```

### Step 4: Handle Errors

Common errors and resolutions:

| Error | Resolution |
|-------|------------|
| `item not found` | Verify item name, try listing items in vault |
| `vault not found` | List available vaults with `op vault list` |
| `more than one item matches` | Use item ID instead of name, or specify vault with `--vault` |
| `permission denied` | Verify vault access permissions |

# Reference Documentation

- [op CLI Delete Command Reference](references/op-delete-commands.md) - Complete command syntax for delete and archive operations


---
Source attribution: leefowlercu
Original project: https://github.com/leefowlercu/agent-kit/blob/a92693f97cc314db2ff53bbc9640ea519d63bf66/plugins/op-secrets-manager/skills/op-secrets-deleter/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 Lee Fowler

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: leefowlercu
Original project: https://github.com/leefowlercu/agent-kit/blob/a92693f97cc314db2ff53bbc9640ea519d63bf66/plugins/op-secrets-manager/skills/op-secrets-deleter/SKILL.md
Attribution basis: Recovered original package and original project license at a pinned revision

Fields of work: Operations, Sales
Roles: Customer Success Manager, IT Operations
Specialties: API
Tools: 1Password, Op Cli
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: fe201d170661bbf7cef05720b79a298c98d79f221939b1a6d067131cec9aa847
Metadata reviewed: 2026-10-27
This metadata supersedes earlier Dave AI catalog attribution. Original instruction and supporting files are preserved.