Agent skill · security · aiskillstore
1password-credential-lookup
This skill should be used when agents need to log into websites, retrieve passwords, or access credentials. CRITICAL - always use find_credential with the website URL, never guess item names.
Why this skill is useful
Provides specific domain knowledge on how to securely retrieve credentials using 1Password's API, which the AI wouldn't reliably generate on its own.
What it needs
Requires 1password installed locally. Requires 1password account access. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
1Password Credential Lookup CRITICAL: Use URL, Not Item Names WRONG: RIGHT: The One Rule When logging into a website, use findcredential with the domain. 1Password items have arbitrary names that don't match URLs. The findcredential tool searches by the URL field stored in 1Password, which matches the website you're visiting. Tools (in order of preference) 1. findcredential - PRIMARY TOOL Use this for ALL credential lookups: Parameters: url (required): Domain of website (e.g., "github.com", "twitter.com") username (optional): Filter by username when multiple accounts exist Returns: Single match: {"username": "...", "password": "...", "itemname": "..."} Multiple matches: List of accounts to choose from No match: Error message 2. listitemsforurl - When unsure which account Shows all accounts for a domain with usernames. Use before findcredential if you don't know which account to use. 3. getcredential - RARELY NEEDED Only use if you have an exact item ID (like ct2jszznlzlp7r7jeb53rhy5li). Never pass URLs or guessed names. Workflow Example When logging into github.com: Domain Aliases These domains are treated as equivalent: x.com ↔ twitter.com Error Handling Error Solution ---------------------- ---------------------------------- "No items found" Check domain spelling "Multiple items found" Add username parameter to filter "op CLI not installed" User needs 1Password CLI "Timed out" User needs to run op signin Anti-Patterns NEVER do these: getcredential(itemname="github.com") - URL is not an item name getcredential(itemname="GitHub") - Guessed names don't work getcredential(itemname="my github") - Item names are arbitrary ALWAYS do this: findcredential(url="github.com") - Search by the website URL
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/1password-credential-lookup