@igorlau/dotagents 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +9 -9
  2. package/THIRD_PARTY_NOTICES.md +2 -2
  3. package/content/skills/{code-review → dot-code-review}/SKILL.md +1 -1
  4. package/content/skills/{commit → dot-commit}/SKILL.md +1 -1
  5. package/content/skills/{debug → dot-debug}/SKILL.md +1 -1
  6. package/content/skills/{debug → dot-debug}/UPSTREAM.json +1 -1
  7. package/content/skills/{docs-writing → dot-docs-writing}/SKILL.md +1 -1
  8. package/content/skills/{docs-writing → dot-docs-writing}/references/formatting.md +1 -1
  9. package/content/skills/{docs-writing → dot-docs-writing}/references/global-and-accessible.md +1 -1
  10. package/content/skills/{docs-writing → dot-docs-writing}/references/word-list.md +1 -1
  11. package/content/skills/{grill-me → dot-grill-me}/SKILL.md +2 -2
  12. package/content/skills/{grill-me → dot-grill-me}/UPSTREAM.json +1 -1
  13. package/content/skills/{grilling → dot-grilling}/SKILL.md +1 -1
  14. package/content/skills/{grilling → dot-grilling}/UPSTREAM.json +1 -1
  15. package/content/skills/{handoff → dot-handoff}/SKILL.md +1 -1
  16. package/content/skills/{handoff → dot-handoff}/UPSTREAM.json +1 -1
  17. package/content/skills/{plan → dot-plan}/SKILL.md +2 -2
  18. package/content/skills/{writing-for-agents → dot-writing-for-agents}/SKILL-MECHANICS.md +1 -1
  19. package/content/skills/{writing-for-agents → dot-writing-for-agents}/SKILL.md +1 -1
  20. package/content/skills/{writing-for-agents → dot-writing-for-agents}/UPSTREAM.json +1 -1
  21. package/dist/build-info.json +1 -1
  22. package/dist/targets.js +6 -10
  23. package/package.json +1 -1
  24. /package/content/skills/{debug → dot-debug}/agents/openai.yaml +0 -0
  25. /package/content/skills/{debug → dot-debug}/scripts/hitl-loop.template.sh +0 -0
  26. /package/content/skills/{grill-me → dot-grill-me}/agents/openai.yaml +0 -0
  27. /package/content/skills/{grilling → dot-grilling}/agents/openai.yaml +0 -0
  28. /package/content/skills/{handoff → dot-handoff}/agents/openai.yaml +0 -0
  29. /package/content/skills/{writing-for-agents → dot-writing-for-agents}/agents/openai.yaml +0 -0
package/README.md CHANGED
@@ -63,15 +63,15 @@ The following skills load when a task needs them:
63
63
 
64
64
  | Skill | Purpose |
65
65
  | ----- | ------- |
66
- | `plan` | Plan a change as small, verifiable steps. |
67
- | `code-review` | Review a diff for correctness bugs. |
68
- | `commit` | Commit changes as small, logical commits. |
69
- | `docs-writing` | Write docs in the Google developer documentation style. |
70
- | `debug` | Diagnose hard bugs with a feedback loop. |
71
- | `grill-me` | Start an interview that sharpens a plan. |
72
- | `grilling` | Run the interview method behind `grill-me`. |
73
- | `handoff` | Summarize a conversation for another agent. |
74
- | `writing-for-agents` | Write skills, `AGENTS.md`, and `CLAUDE.md` files. |
66
+ | `dot-plan` | Plan a change as small, verifiable steps. |
67
+ | `dot-code-review` | Review a diff for correctness bugs. |
68
+ | `dot-commit` | Commit changes as small, logical commits. |
69
+ | `dot-docs-writing` | Write docs in the Google developer documentation style. |
70
+ | `dot-debug` | Diagnose hard bugs with a feedback loop. |
71
+ | `dot-grill-me` | Start an interview that sharpens a plan. |
72
+ | `dot-grilling` | Run the interview method behind `dot-grill-me`. |
73
+ | `dot-handoff` | Summarize a conversation for another agent. |
74
+ | `dot-writing-for-agents` | Write skills, `AGENTS.md`, and `CLAUDE.md` files. |
75
75
 
76
76
  ## More information
77
77
 
@@ -4,7 +4,7 @@ dotagents includes content from the following projects.
4
4
 
5
5
  ## mattpocock/skills
6
6
 
7
- The `debug`, `grill-me`, `grilling`, `handoff`, and `writing-for-agents`
7
+ The `dot-debug`, `dot-grill-me`, `dot-grilling`, `dot-handoff`, and `dot-writing-for-agents`
8
8
  skills come from [mattpocock/skills](https://github.com/mattpocock/skills).
9
9
  Each skill's `UPSTREAM.json` file records the source commit and any local
10
10
  changes. The project is licensed under the MIT License:
@@ -66,7 +66,7 @@ SOFTWARE.
66
66
 
67
67
  ## Google developer documentation style guide
68
68
 
69
- The `docs-writing` skill is adapted from the
69
+ The `dot-docs-writing` skill is adapted from the
70
70
  [Google developer documentation style guide](https://developers.google.com/style)
71
71
  by Google, licensed under the
72
72
  [Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/).
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: code-review
2
+ name: dot-code-review
3
3
  description: Review a diff for correctness bugs. Use when the user asks to review code, a commit, a branch, or a pull request, or before committing a non-trivial change.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: commit
2
+ name: dot-commit
3
3
  description: Commit changes as small, logical commits, with the user reviewing each one. Use when the user asks to commit, write a commit message, or split work into commits.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: debug
2
+ name: dot-debug
3
3
  description: Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
4
4
  ---
5
5
 
@@ -4,5 +4,5 @@
4
4
  "commit": "49dd158d1076134a641b33efb035946536778336",
5
5
  "license": "MIT",
6
6
  "modified": true,
7
- "notes": "Renamed from diagnosing-bugs to debug (frontmatter name and display_name). Added a 'Repository conventions first' section."
7
+ "notes": "Renamed from diagnosing-bugs to debug (frontmatter name and display_name). Added a 'Repository conventions first' section. Renamed with the dot- prefix."
8
8
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: docs-writing
2
+ name: dot-docs-writing
3
3
  description: Write and edit developer documentation in the Google developer documentation style. Use when creating or revising a README, guide, tutorial, reference page, changelog, or code comments meant for readers.
4
4
  ---
5
5
 
@@ -1,6 +1,6 @@
1
1
  # Formatting reference
2
2
 
3
- Detailed formatting rules for the [`docs-writing`](../SKILL.md) skill.
3
+ Detailed formatting rules for the [`dot-docs-writing`](../SKILL.md) skill.
4
4
 
5
5
  ## Headings and titles
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Global and accessible writing
2
2
 
3
- Rules for the [`docs-writing`](../SKILL.md) skill that help readers who use translation tools, read in a second language, or use assistive technology.
3
+ Rules for the [`dot-docs-writing`](../SKILL.md) skill that help readers who use translation tools, read in a second language, or use assistive technology.
4
4
 
5
5
  ## Global audience
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Word list
2
2
 
3
- Words and phrases for the [`docs-writing`](../SKILL.md) skill. Each entry lists the word to replace and what to write instead.
3
+ Words and phrases for the [`dot-docs-writing`](../SKILL.md) skill. Each entry lists the word to replace and what to write instead.
4
4
 
5
5
  ## Filler and judgment words
6
6
 
@@ -1,10 +1,10 @@
1
1
  ---
2
- name: grill-me
2
+ name: dot-grill-me
3
3
  description: A relentless interview to sharpen a plan or design.
4
4
  disable-model-invocation: true
5
5
  ---
6
6
 
7
- Use the `grilling` skill to interview the user about the plan or design they describe.
7
+ Use the `dot-grilling` skill to interview the user about the plan or design they describe.
8
8
 
9
9
  ## Repository conventions first
10
10
 
@@ -4,5 +4,5 @@
4
4
  "commit": "49dd158d1076134a641b33efb035946536778336",
5
5
  "license": "MIT",
6
6
  "modified": true,
7
- "notes": "Replaced the Claude-specific 'Call the Skill tool' instruction with an agent-neutral one. Added a 'Repository conventions first' section."
7
+ "notes": "Replaced the Claude-specific 'Call the Skill tool' instruction with an agent-neutral one. Added a 'Repository conventions first' section. Renamed with the dot- prefix."
8
8
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: grilling
2
+ name: dot-grilling
3
3
  description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
4
4
  ---
5
5
 
@@ -4,5 +4,5 @@
4
4
  "commit": "49dd158d1076134a641b33efb035946536778336",
5
5
  "license": "MIT",
6
6
  "modified": true,
7
- "notes": "Added a 'Repository conventions first' section."
7
+ "notes": "Added a 'Repository conventions first' section. Renamed with the dot- prefix."
8
8
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: handoff
2
+ name: dot-handoff
3
3
  description: Compact the current conversation into a handoff document for another agent to pick up.
4
4
  argument-hint: "What will the next session be used for?"
5
5
  disable-model-invocation: true
@@ -4,5 +4,5 @@
4
4
  "commit": "49dd158d1076134a641b33efb035946536778336",
5
5
  "license": "MIT",
6
6
  "modified": true,
7
- "notes": "Added a 'Repository conventions first' section."
7
+ "notes": "Added a 'Repository conventions first' section. Renamed with the dot- prefix."
8
8
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: plan
2
+ name: dot-plan
3
3
  description: Plan a change as small, verifiable steps before writing code. Use when the user asks for a plan, or before a feature, refactor, or migration that touches more than one file.
4
4
  ---
5
5
 
@@ -27,7 +27,7 @@ Facts are your job: look them up instead of asking. Done when you can name every
27
27
 
28
28
  List the choices that the facts don't settle: behavior in edge cases, trade-offs, naming that users see, anything hard to reverse. Give your recommendation for each one.
29
29
 
30
- If the list is long or the decisions depend on each other, use the `grilling` skill to resolve them with the user. Done when every decision has an answer or is marked as an open question in the plan.
30
+ If the list is long or the decisions depend on each other, use the `dot-grilling` skill to resolve them with the user. Done when every decision has an answer or is marked as an open question in the plan.
31
31
 
32
32
  ## 4. Slice the work
33
33
 
@@ -1,6 +1,6 @@
1
1
  # Skill mechanics
2
2
 
3
- The skill-specific branch of [`writing-for-agents`](SKILL.md): what changes when the document is a skill (frontmatter, the invocation choice, and router skills). Everything else about writing it is the universal reference in `SKILL.md`.
3
+ The skill-specific branch of [`dot-writing-for-agents`](SKILL.md): what changes when the document is a skill (frontmatter, the invocation choice, and router skills). Everything else about writing it is the universal reference in `SKILL.md`.
4
4
 
5
5
  ## Invocation
6
6
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: writing-for-agents
2
+ name: dot-writing-for-agents
3
3
  description: Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
4
4
  ---
5
5
 
@@ -4,5 +4,5 @@
4
4
  "commit": "49dd158d1076134a641b33efb035946536778336",
5
5
  "license": "MIT",
6
6
  "modified": true,
7
- "notes": "Added a 'Repository conventions first' section."
7
+ "notes": "Added a 'Repository conventions first' section. Renamed with the dot- prefix."
8
8
  }
@@ -1 +1 @@
1
- {"commit":"353f166"}
1
+ {"commit":"0618870"}
package/dist/targets.js CHANGED
@@ -3,7 +3,6 @@ import { agentsHome, claudeHome, codexHome, copilotHome } from "./paths.js";
3
3
  export const AGENTS = ["claude", "codex", "copilot"];
4
4
  const HEADER = "<!-- Managed by dotagents. Run `dotagents update` instead of editing this file. -->";
5
5
  const RULES_FILE = "dotagents.md";
6
- const COPILOT_RULES_FILE = "dotagents.instructions.md";
7
6
  function layout(mode, root) {
8
7
  if (mode === "global") {
9
8
  return {
@@ -14,7 +13,9 @@ function layout(mode, root) {
14
13
  },
15
14
  claudeRules: path.join(claudeHome(), "rules", RULES_FILE),
16
15
  codexRules: path.join(codexHome(), "AGENTS.md"),
17
- copilotRules: { kind: "file", path: path.join(copilotHome(), "instructions", COPILOT_RULES_FILE) },
16
+ // Copilot loads this file in every session; files in ~/.copilot/instructions/
17
+ // load only when their applyTo pattern matches a file being edited.
18
+ copilotRules: path.join(copilotHome(), "copilot-instructions.md"),
18
19
  };
19
20
  }
20
21
  // Copilot reads AGENTS.md too, so both agents share one block.
@@ -27,7 +28,7 @@ function layout(mode, root) {
27
28
  },
28
29
  claudeRules: path.join(root, ".claude", "rules", RULES_FILE),
29
30
  codexRules: agentsMd,
30
- copilotRules: { kind: "block", path: agentsMd },
31
+ copilotRules: agentsMd,
31
32
  };
32
33
  }
33
34
  export function planInstall(catalog, mode, agents, root = "") {
@@ -52,13 +53,8 @@ export function planInstall(catalog, mode, agents, root = "") {
52
53
  }
53
54
  if (agents.includes("codex"))
54
55
  add({ kind: "block", path: target.codexRules, content: rules });
55
- if (agents.includes("copilot")) {
56
- const { kind, path: rulesPath } = target.copilotRules;
57
- if (kind === "block")
58
- add({ kind, path: rulesPath, content: rules });
59
- else
60
- add({ kind, path: rulesPath, content: `---\napplyTo: "**"\n---\n\n${HEADER}\n\n${rules}\n` });
61
- }
56
+ if (agents.includes("copilot"))
57
+ add({ kind: "block", path: target.copilotRules, content: rules });
62
58
  return [...ops.values()];
63
59
  }
64
60
  export function parseAgents(value) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@igorlau/dotagents",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "Install a curated set of agent skills and rules into Claude Code, Codex, and GitHub Copilot.",
5
5
  "license": "MIT",
6
6
  "repository": {