How do I install the 1password skill?

Run npx skillmds@latest add understudy-ai/1password in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is 1password safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with 1password?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is 1password free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published 1password?

understudy-ai (@understudy-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

1password by understudy-ai — Agent Skill

Name: 1password
Author: understudy-ai

File contents

1Password CLI

Follow the official CLI get-started steps. Don't guess install commands.

References

references/get-started.md (install + app integration + sign-in flow)
references/cli-examples.md (real op examples)

Workflow

Check OS + shell.
Verify CLI present: op --version.
Confirm desktop app integration is enabled (per get-started) and the app is unlocked.
REQUIRED: create a fresh tmux session for all op commands (no direct op calls outside tmux).
Sign in / authorize inside tmux: op signin (expect app prompt).
Verify access inside tmux: op whoami (must succeed before any secret read).
If multiple accounts: use --account or OP_ACCOUNT.

REQUIRED tmux session (T-Max)

The shell tool uses a fresh TTY per command. To avoid re-prompts and failures, always run op inside a dedicated tmux session with a fresh socket/session name.

Example (see tmux skill for socket conventions, do not reuse old session names):

SOCKET_DIR="${UNDERSTUDY_TMUX_SOCKET_DIR:-${UNDERSTUDY_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/understudy-tmux-sockets}}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/understudy-op.sock"
SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op whoami" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op vault list" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
tmux -S "$SOCKET" kill-session -t "$SESSION"

Guardrails

Never paste secrets into logs, chat, or code.
Prefer op run / op inject over writing secrets to disk.
If sign-in without app integration is needed, use op account add.
If a command returns "account is not signed in", re-run op signin inside tmux and authorize in the app.
Do not run op outside tmux; stop and ask if tmux is unavailable.

---name: 1passworddescription: Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.---# 1Password CLIFollow the official CLI get-started steps. Don't guess install commands.## References- `references/get-started.md` (install + app integration + sign-in flow)- `references/cli-examples.md` (real `op` examples)## Workflow1. Check OS + shell.2. Verify CLI present: `op --version`.3. Confirm desktop app integration is enabled (per get-started) and the app is unlocked.4. REQUIRED: create a fresh tmux session for all `op` commands (no direct `op` calls outside tmux).5. Sign in / authorize inside tmux: `op signin` (expect app prompt).6. Verify access inside tmux: `op whoami` (must succeed before any secret read).7. If multiple accounts: use `--account` or `OP_ACCOUNT`.## REQUIRED tmux session (T-Max)The shell tool uses a fresh TTY per command. To avoid re-prompts and failures, always run `op` inside a dedicated tmux session with a fresh socket/session name.Example (see `tmux` skill for socket conventions, do not reuse old session names):```bashSOCKET_DIR="${UNDERSTUDY_TMUX_SOCKET_DIR:-${UNDERSTUDY_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/understudy-tmux-sockets}}"mkdir -p "$SOCKET_DIR"SOCKET="$SOCKET_DIR/understudy-op.sock"SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"tmux -S "$SOCKET" new -d -s "$SESSION" -n shelltmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op signin --account my.1password.com" Entertmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op whoami" Entertmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op vault list" Entertmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200tmux -S "$SOCKET" kill-session -t "$SESSION"```## Guardrails- Never paste secrets into logs, chat, or code.- Prefer `op run` / `op inject` over writing secrets to disk.- If sign-in without app integration is needed, use `op account add`.- If a command returns "account is not signed in", re-run `op signin` inside tmux and authorize in the app.- Do not run `op` outside tmux; stop and ask if tmux is unavailable.

Frequently asked questions

1password