One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
black12-agAGENTS.mdblack12-ag/weft/AGENTS.md
This file provides guidance when working with code in this repository. Environment variables: - SERVERROOTURL - HTTP endpoint (default: http://localhost:8080) - WSSERVERURL - WebSocket endpoint (default: ws://localhost:8080/graphql/v2) skills-lock.json is the…
black12-agSkillblack12-ag/weft/.agents/skills/add-feature-flag/SKILL.md
Add a new feature flag to gate code changes in the Warp codebase.
Steady4 mentions in 2 weeks
9 projects use a version of this
Often used withadd-telemetrypromote-featurerust-unit-tests
black12-agSkillblack12-ag/weft/.agents/skills/add-telemetry/SKILL.md
Add telemetry events to track user behavior or system events in the Warp codebase. Use when instrumenting new features, debugging issues, or measuring product metrics.
Steady4 mentions in 2 weeks
5 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/changelog-draft/SKILL.md
Generate a reviewable changelog draft from PRs merged in a release range. Extracts explicit CHANGELOG markers, classifies unmarked PRs, adds external contributor attribution, and outputs markdown + JSON artifacts. Does NOT mutate channel_versions.json.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/classify-changelog-pr/SKILL.md
Reference guidance for classifying whether an unmarked PR should appear in the changelog and under which category. Used inline by the changelog-draft skill — not dispatched as a separate agent.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/cross-platform-cloud-verification/SKILL.md
Orchestrates cost-conscious cloud verification across available operating-system and architecture runners after cheaper checks pass. Use whenever a code change, bug fix, build, packaging flow, native dependency, UI behavior, filesystem behavior, or test has material cross-platform implications, even if the user only asks to verify or test the change. Consult domain verification skills for what to test; use this skill to choose and access the smallest relevant set of platforms.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/dedupe-issue-local/SKILL.md
Repo-specific dedupe guidance for warp. Only the categories declared overridable by the core dedupe-issue skill may be specialized here.
Steady4 mentions in 2 weeks
6 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/gui-create-launch-modal/SKILL.md
GUI desktop app only. Create a one-time launch modal in the Warp client (feature announcement, onboarding, etc.). Use when adding a new modal that should appear exactly once per user on startup, gated by a feature flag, with colors sourced from Warp theme tokens and terminal theme colors.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/gui-integration-test/SKILL.md
GUI desktop app only. Writes, runs, and debugs Warp integration tests using the custom Builder/TestStep framework in `crates/integration`. Use when adding a new integration test, fixing a failing integration test, wiring a test into the manual runner or nextest suite, or verifying end-to-end UI and terminal behavior in Warp.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/gui-onboarding-verification-skill/SKILL.md
GUI desktop app only. Launch two parallel Oz cloud agents with computer use to download and install the latest stable Linux Warp build, capture screenshots while walking through first-time onboarding in both logged-out and logged-in states, then selectively fan out follow-up cloud agents for distinct onboarding branches proposed by those initial explorers. Use this whenever the user asks to test, document, screenshot, or walk through the Warp first-time install/onboarding experience in a cloud Linux environment.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/gui-reproduce-bug-report-local/SKILL.md
GUI desktop app only. Repo-specific bug reproduction guidance for Warp. Specializes the core reproduce-bug-report skill for logged-out Warp UI repros, exact reporter-version installs, and login-free onboarding.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/gui-settings-ui/SKILL.md
GUI desktop app only. How to build a Settings page in the Warp client (app/src/settings_view) so its widgets and settings search behave correctly — picking a PageType, deciding whether a heading belongs in the page-title slot or inside a widget, gating a widget, and scoping search_terms per widget. Use when adding or editing a settings page, a SettingsWidget, or anything that affects settings search.
black12-agSkillblack12-ag/weft/.agents/skills/gui-ui-guidelines/SKILL.md
GUI desktop app only. Catalog of guidelines for writing UI code in the Warp client. Read whenever doing any UI work in this repo, up front before writing the change, so the relevant guidelines shape the implementation.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/logging-and-error-reporting/SKILL.md
How and when to log (log::* levels, safe_* macros) and report errors to Sentry (report_error!) in the Warp codebase. Use when adding or reviewing any logging or error reporting — picking a log level, deciding log vs. report_error!, keeping sensitive data out of logs, or surfacing an error to Sentry.
Steady4 mentions in 2 weeks
3 projects use a version of this
black12-agSkillblack12-ag/weft/.agents/skills/promote-feature/SKILL.md
Promote a feature-flagged feature to Dogfood, Preview, or Stable in the Warp codebase. Use when a feature behind a FeatureFlag is ready to roll out to a broader audience, including wiring up the compile-time/runtime bridge and deferring flag cleanup safely.
black12-agSkillblack12-ag/weft/.agents/skills/remove-feature-flag/SKILL.md
Remove a feature flag after it has been rolled out and stabilized in the Warp codebase.
black12-agSkillblack12-ag/weft/.agents/skills/review-pr-local/SKILL.md
Repo-specific review guidance for warp. Only the categories declared overridable by the core review-pr skill may be specialized here.
Often used withdedupe-issue-localtriage-issue-localadd-telemetry
black12-agSkillblack12-ag/weft/.agents/skills/rust-unit-tests/SKILL.md
Write, improve, and run Rust unit tests in the warp Rust codebase.
black12-agSkillblack12-ag/weft/.agents/skills/triage-issue-local/SKILL.md
Repo-specific triage guidance for warp. Only the categories declared overridable by the core triage-issue skill may be specialized here.
black12-agSkillblack12-ag/weft/.agents/skills/tui-testing/SKILL.md
Write and run unit tests for Warp TUI (crates/warp_tui) elements/screens by rendering to text lines. Use for TUI test work.
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
