obraAGENTS.mdobra/superpowers/AGENTS.md
Stop. Read this section before doing anything. This repo has a 94% PR rejection rate. Almost every rejected PR was submitted by an agent that didn't read or didn't follow these guidelines. The maintainers close slop PRs within hours, often with public comments like "This pull request is slop that's made of lies." Your job is to protect your human partner from that outcome. Submitting a low-quality PR doesn't help them — it wastes the maintainers' time, burns your human…
obraSkill obra/superpowers/skills/brainstorming/SKILL.md
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
obraSkill obra/superpowers/skills/diagnosing-superpowers/SKILL.md
Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.
obraSkill obra/superpowers/skills/dispatching-parallel-agents/SKILL.md
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
obraSkill obra/superpowers/skills/finishing-a-development-branch/SKILL.md
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work
obraSkill obra/superpowers/skills/receiving-code-review/SKILL.md
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
obraSkill obra/superpowers/skills/requesting-code-review/SKILL.md
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
obraSkill obra/superpowers/skills/systematic-debugging/SKILL.md
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
obraSkill obra/superpowers/skills/test-driven-development/SKILL.md
Use when implementing any feature or bugfix, before writing implementation code
obraSkill obra/superpowers/skills/using-git-worktrees/SKILL.md
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback
obraSkill obra/superpowers/skills/using-superpowers/SKILL.md
Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions
obraSkill obra/superpowers/skills/verification-before-completion/SKILL.md
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
obraSkill obra/superpowers/skills/writing-plans/SKILL.md
Use when you have a spec or requirements for a multi-step task, before touching code
obraSkill obra/superpowers/skills/writing-skills/SKILL.md
Use when creating new skills, editing existing skills, or verifying skills work before deployment
NousResearchAGENTS.mdNousResearch/hermes-agent/agent/AGENTS.md
Applies on top of the root AGENTS.md (prompt-caching invariant, facade + siblings rules). runagent.py is the public facade: AIAgent is assembled from mixins (agent/turnfacade.py, clientlifecycle.py, streamdelivery.py, sessionpersistence.py, compressionfacade.py, ...). Construction runs agent/agentinit.py::initagent; a turn is agent/conversationloop.py::runconversation, which AIAgent.runconversation forwards to after taking the session turn lease (turnfacadelease.py). AIAgent.init_ takes ~60 parameters (credentials, routing, callbacks, session context, budget, credential pool, ...) — read runagent.py for the list; the subset you usually touch: baseurl, apikey, provider, apimode ("chatcompletions" | "codexresponses" | ...),…
NousResearchAGENTS.md NousResearch/hermes-agent/plugins/AGENTS.md
Applies on top of the root AGENTS.md. Authoring guide + canonical compat contract: website/docs/developer-guide/plugins/index.md. Per-kind guides: memory-provider-plugin.md, model-provider-plugin.md, context-engine-plugin.md, image-gen-provider-plugin.md, ... Plugins live in their own directory and work within the ABCs / hooks / ctx surface we provide. A plugin MUST NOT modify runagent.py, cli.py, gateway/run.py, hermescli/main.py, etc. If it needs a capability the framework lacks, widen the generic plugin surface (new hook, new ctx method) and have the plugin use it — never hardcode plugin-specific logic into core…
NousResearchSkill NousResearch/hermes-agent/skills/apple/apple-notes/SKILL.md
Manage Apple Notes via memo CLI: create, search, edit.
NousResearchSkill NousResearch/hermes-agent/skills/apple/apple-reminders/SKILL.md
Apple Reminders via remindctl: add, list, complete.
NousResearchSkill NousResearch/hermes-agent/skills/apple/findmy/SKILL.md
Track Apple devices/AirTags via FindMy.app on macOS.
NousResearchSkill NousResearch/hermes-agent/skills/apple/imessage/SKILL.md
Send and receive iMessages/SMS via the imsg CLI on macOS.
