baldaworks/promptkitty / plugins/promptkitty/skills/author-agent-instructions
author-agent-instructions
VerifiedTurn a fully assembled PromptKit prompt into ready-to-commit project instructions or a provider-native subagent profile. Use when the user asks to create persistent agent guidance, custom agent instructions, an agent profile, a subagent, or equivalent files for Codex, Claude Code, Grok Build, GitHub Copilot, OpenCode, or Cursor.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.1 KB |
| agents/openai.yaml | config | 249 B |
| references/provider-targets.md | markdown | 3.2 KB |
references/provider-targets.md
View on GitHub# Provider targets
Use lowercase kebab-case slugs. Keep generated instructions concise, imperative, self-contained, and ready to commit. Omit optional model, tool, and permission fields unless the user requests them.
## Managed project instructions
Wrap generated Markdown body content with stable markers:
```markdown
<!-- promptkitty:<slug>:begin -->
<generated instructions>
<!-- promptkitty:<slug>:end -->
```
On regeneration, replace only the matching block. Keep required YAML frontmatter outside the block. When an existing target has no matching block, show a diff and obtain confirmation before appending; never replace unrelated content.
| Provider | Target | Required shape |
|---|---|---|
| Codex | `AGENTS.md` | Plain Markdown managed block. |
| Claude Code | `.claude/rules/<slug>.md` | Plain Markdown managed block without `paths` frontmatter for project-wide scope. Add `paths` only when supplied by the user. |
| Grok Build | `.grok/rules/<slug>.md` | Plain Markdown managed block. |
| GitHub Copilot | `.github/instructions/<slug-or-concern>.instructions.md` | YAML `description` and `applyTo`; use `applyTo: '**'` unless the user supplies a narrower scope. The authoring specification may decompose independent concerns into multiple files. |
| OpenCode | `AGENTS.md` | Plain Markdown managed block shared with Codex. When both are selected, create one block and list both consumers in the manifest. |
| Cursor | `.cursor/rules/<slug>.mdc` | YAML `alwaysApply: true` for project-wide scope. Use `description` plus `alwaysApply: false` only when the user requests relevance-based activation; use `globs` only for an explicit path scope. |
## Subagent profiles
Create one standalone profile per selected provider. The instruction body comes from the condensed assembled source. Existing files require preview and explicit overwrite approval.
| Provider | Target | Minimum required shape |
|---|---|---|
| Codex | `.codex/agents/<slug>.toml` | TOML strings `name`, `description`, and `developer_instructions`. Encode multiline content as valid TOML and validate it before writing. |
| Claude Code | `.claude/agents/<slug>.md` | YAML `name` and `description`, followed by the instruction body. |
| Grok Build | `.grok/agents/<slug>.md` | YAML `name` and `description`, followed by the instruction body. Grok also understands Claude-compatible agent fields, but omit them by default. |
| GitHub Copilot | `.github/agents/<slug>.agent.md` | YAML `name`, `description`, and `user-invocable: false`, followed by the instruction body. |
| OpenCode | `.opencode/agents/<slug>.md` | YAML `description` and `mode: subagent`, followed by the instruction body; the filename supplies the agent name. |
| Cursor | `.cursor/agents/<slug>.md` | YAML `name` and `description`, followed by the instruction body. |
## Verification
- Resolve and normalize every target beneath the confirmed project root.
- Deduplicate `AGENTS.md` when Codex and OpenCode are both selected.
- Preserve YAML frontmatter while updating managed blocks.
- Reject unresolved Mustache parameters.
- Ensure the provider file contains no PromptKit assembly headers or instructions to read PromptKit source files.
- Mention how the selected host discovers or invokes each resulting file.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse 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. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |