Using Agent Skills
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
Audits the AI skills installed for a project for duplicate names, broad triggers and conflicting instructions, without changing any of them.
Install Birdview Skills Compatibility Audit
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Qiuner/birdview birdview-compatibility --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .claude/skills && cp -r skills-src/compatibility-audit .claude/skills/birdview-compatibility && rm -rf skills-srcUse ~/.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/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .claude/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Qiuner/birdview/tree/main/compatibility-auditType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Qiuner/birdview birdview-compatibility --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .agents/skills && cp -r skills-src/compatibility-audit .agents/skills/birdview-compatibility && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .agents/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Qiuner/birdview birdview-compatibility --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/compatibility-audit .cursor/skills/birdview-compatibility && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .cursor/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Qiuner/birdview.git --path compatibility-audit--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Qiuner/birdview birdview-compatibility --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/compatibility-audit .gemini/skills/birdview-compatibility && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .gemini/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Qiuner/birdview birdview-compatibilityInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .github/skills && cp -r skills-src/compatibility-audit .github/skills/birdview-compatibility && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .github/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Qiuner/birdview --skill birdview-compatibility -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Qiuner/birdview birdview-compatibility --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Qiuner/birdview.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/compatibility-audit .opencode/skills/birdview-compatibility && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "birdview-compatibility" agent skill from https://github.com/Qiuner/birdview/tree/main/compatibility-audit into .opencode/skills/birdview-compatibility/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "birdview-compatibility", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
birdview-compatibility- GitHub stars
- 715
- Token cost
- ~794 tokens
- SKILL.md length
- 333 words
- Files
- 5 (incl. references)
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Audits the AI skills installed for a project for duplicate names, broad triggers and conflicting instructions, without changing any of them.
- Checking an installed skill set for duplicates and overlapping triggers
- Calls node
- Finding out whether two skills give conflicting instructions
- Reviewing which skills activate automatically and what they may write
What it does
This skill takes an inventory of the skills installed for a project and checks them against each other for duplicate names, overly broad triggers and instructions that may conflict. It runs only when you call it by name, and it never edits or activates other skills.
A bundled Node script lists the discovered skill roots, skills, duplicate names and metadata flags and writes the result to a JSON file in the project. The agent must then read every discovered SKILL.md, compare names, trigger descriptions, invocation policy, write permissions and approval gates, and write its own assessment following the report contract in the references folder.
The final Markdown report classifies each pair of skills with overlapping triggers as compatible, needing an order, a potential conflict or unresolved, with confidence, rationale, quoted passages from both skills and a suggested execution order. Duplicate names alone are not treated as a conflict. The language flag follows the language of your conversation, English or Chinese.
When your agent uses it
- Checking an installed skill set for duplicates and overlapping triggers
- Finding out whether two skills give conflicting instructions
- Reviewing which skills activate automatically and what they may write
- Producing a written compatibility report before adding more skills
Example prompts
- “Run birdview-compatibility on this project and show me any skills that conflict.”
- “Audit my installed skills for duplicate names and triggers that are too broad.”
- “Write the compatibility report in Chinese and recommend an execution order for overlapping skills.”
Requirements
- Node.js to run the bundled Birdview script
What it can do on your machine
Read from SKILL.md and the folder at commit acddbf0. 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
Shell commands in SKILL.md call:
node
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
Birdview Skills Compatibility Audit loads about 794 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 333 words of instructions outside code blocks.
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 Qiuner/birdview at commit acddbf0, republished under its MIT licence (© Qiuner). 333 words, ~794 tokens.
Download SKILL.mdSave it as
.claude/skills/birdview-compatibility/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.- name
- birdview-compatibility
- description
- Audit the installed AI skill environment for duplicate installations, broad triggers and possible instruction conflicts. Use only when the user invokes birdview-compatibility; it does not activate architecture mapping or modify skills.
Birdview skills audit
Run the read-only inventory from the installed Birdview bundle:
node <skill-root>/scripts/birdview.mjs skills audit --project <project-root> --language en --write <project-root>/.birdview/compatibility-audit.jsonSet --language to the language of the current user conversation (zh for Chinese, en for English); the CLI cannot infer conversation language by itself. Always pass it when producing the human-readable Markdown report.
The JSON is deliberately two-layered. skills, duplicateNames and issues are inventory facts; assessment is the required human conclusion. Inventory is not the finished audit. In the same turn, read every discovered SKILL.md and compare at least names, trigger descriptions, explicit invocation requirements, automatic invocation policy, disable-model-invocation, write permissions and approval gates. Then write the assessment using the report contract and render both artifacts:
node <skill-root>/scripts/birdview.mjs skills audit --project <project-root> --language en --assessment <project-root>/.birdview/compatibility-assessment.json --write <project-root>/.birdview/compatibility-audit.json --write-markdown <project-root>/.birdview/compatibility-audit.mdThe Markdown report is for people: every pair with overlapping trigger scope must state the triggering language, whether the skills are compatible, need ordering, may conflict or remain unresolved, with confidence, rationale, quoted evidence and a recommended execution order. Keep a relationship unresolved only when the bodies or host rules cannot be read; do not leave an empty unreviewed report merely because the inventory succeeded.
Report the discovered roots, skills, duplicate names and metadata flags, then complete trigger compatibility analysis. Read both bodies for skills with similar trigger descriptions, automatic activation, shared task domains, or an instruction that applies to every conversation. Classify each such relationship as compatible, ordered, potential conflict or unresolved. Compare activation policy, write permissions, approval gates, output ownership and explicit scope. Show both source passages for any claimed conflict; duplicate names alone are not a semantic conflict.
This instruction is an audit request, not approval to change configuration. Do not disable, rewrite, delete or reinstall another skill. Do not start Birdview architecture or constraint mapping unless the user separately asks for it. The inventory is only candidate discovery, not semantic compatibility; preserve the facts, conclusions and specific gaps.
Deliver the Markdown report for human review. Keep it textual and concise: show the conclusion, scenario, impact, evidence and next action. Do not create a graph or label unknown relationships as compatible.
© Qiuner, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 4 other files (references) in compatibility-audit of Qiuner/birdview.
- SKILL.md
- SKILL.zh.md
- agents/openai.yaml
- references/report-contract.md
- references/report-contract.zh.md
Open the folder on GitHubat commit acddbf0
Compare with similar skills
Birdview Skills Compatibility Audit 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Birdview Skills Compatibility Audit this skillQiuner/birdview | 715 | — | ~794 | Automated safety check: Pass | MIT | |
| Using Agent Skillsaddyosmani/agent-skills | 102k | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~12k | Automated safety check: Pass | CC-BY-4.0 | |
| Rules Distillationaffaan-m/ECC | 274k | 2 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Context Routing Auditwithkynam/vibecode-pro-max-kit | 1.1k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Mistral Vibe CLI Referencemistralai/mistral-vibe | 5.1k | — | ~14k | Automated safety check: Notes | Apache-2.0 |
Similar skills
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
Rules Distillation
affaan-m/ECC
Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.
Context Routing Audit
withkynam/vibecode-pro-max-kit
Audits a project's context routing, skill discoverability and skill wiring by running a chain of validator scripts and fixing whatever they report.
- Official
Mistral Vibe CLI Reference
mistralai/mistral-vibe
Reference for Mistral Vibe, the CLI agent it runs inside: config files, env vars, agents, skills, tools, hooks and MCP servers, so the agent can explain and troubleshoot its own setup.
Watchmen Workspace Brief
firstbatchxyz/watchmen
Summarizes what the watchmen tool detected in your workspace since its last curator run: skill changes, AGENTS.md edits and a suggested skill to load.
More from Qiuner/birdview
Birdview Architecture Map
Qiuner/birdview
Shows an evidence-linked map of a codebase's architecture and constraints, highlighting the modules an AI plans to change before it edits anything.
Related
Categories
Questions about Birdview Skills Compatibility Audit
What does Birdview Skills Compatibility Audit do?
Audits the AI skills installed for a project for duplicate names, broad triggers and conflicting instructions, without changing any of them. This skill takes an inventory of the skills installed for a project and checks them against each other for duplicate names, overly broad triggers and instructions that may conflict. It runs only when you call it by name, and it never edits or activates other skills.
When should I use Birdview Skills Compatibility Audit?
Birdview Skills Compatibility Audit fits situations like: checking an installed skill set for duplicates and overlapping triggers; finding out whether two skills give conflicting instructions; reviewing which skills activate automatically and what they may write; producing a written compatibility report before adding more skills.
How do I install Birdview Skills Compatibility Audit in Claude Code?
Run `npx skills add Qiuner/birdview --skill birdview-compatibility -a claude-code`. Or copy the skill folder (compatibility-audit in Qiuner/birdview) into .claude/skills/birdview-compatibility in your project. Claude Code loads it when a task matches its description.
How do I install Birdview Skills Compatibility Audit in Codex?
Run `npx skills add Qiuner/birdview --skill birdview-compatibility -a codex`. Or copy the skill folder (compatibility-audit in Qiuner/birdview) into .agents/skills/birdview-compatibility in your project. Codex loads it when a task matches its description.
Can I use Birdview Skills Compatibility Audit 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 Qiuner/birdview --skill birdview-compatibility -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/birdview-compatibility, .gemini/skills/birdview-compatibility, .github/skills/birdview-compatibility and .opencode/skills/birdview-compatibility in your project.
What does Birdview Skills Compatibility Audit need to run?
Going by SKILL.md and its folder, Birdview Skills Compatibility Audit needs the command-line tools its instructions call (node). Our summary lists: Node.js to run the bundled Birdview script.
Does Birdview Skills Compatibility Audit 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 Birdview Skills Compatibility Audit 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 Birdview Skills Compatibility Audit use?
Birdview Skills Compatibility Audit 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 Birdview Skills Compatibility Audit use?
About 794 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.
What are the alternatives to Birdview Skills Compatibility Audit?
Skills that share tags, products or a category with Birdview Skills Compatibility Audit: Using Agent Skills (addyosmani/agent-skills, 102k stars), Task Observer (rebelytics/one-skill-to-rule-them-all, 3.2k stars), Rules Distillation (affaan-m/ECC, 274k stars) and Context Routing Audit (withkynam/vibecode-pro-max-kit, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Birdview Skills Compatibility Audit?
Qiuner (a GitHub user) maintains it in Qiuner/birdview, which has 715 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 2, 2026.
Source: Qiuner/birdview on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.