Skip to content

Commit a16f24d

Browse files
committed
Agent skills: Ensure deleted.txt is updated
1 parent cdf9c05 commit a16f24d

2 files changed

Lines changed: 16 additions & 0 deletions

File tree

.agent/skills/verify-translator/SKILL.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,10 @@ All tests must pass. If a test fails:
4141
3. Fix the translator code or update the test case (using `create-test` skill).
4242
4. Re-run tests until all pass.
4343

44+
## Retire IDs of deleted translators
45+
46+
If this change deletes a translator, or stops using its ID because it was merged into or replaced by another translator, add the ID and a short reason to `deleted.txt` **and** increment the number on the file's first line. Both edits are required — clients don't pick up the change without the increment.
47+
4448
## Ensure user is working in a Git branch
4549

4650
```

AGENTS.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,18 @@ A single translator can combine multiple types (e.g. import + export for a round
1313

1414
Run any `.bin/` tool with `--help` for usage.
1515

16+
## Deleting translators
17+
18+
Whenever a translator's ID stops being used — the file is deleted outright, merged into another translator, or replaced — you **must** retire the ID in `deleted.txt`. Zotero reads that file to remove the translator from users' installations; skipping it leaves a dead translator running for everyone.
19+
20+
Two edits, both required:
21+
22+
1. Append the ID and a short reason at the end of the file, e.g.
23+
`938ebe32-2b2e-4349-a5b3-b3a05d3de627 # ACS Publications: Now uses Silverchair
24+
2. Increment the number on the file's first line. It's the file's version marker — clients won't pick up the change without it.
25+
26+
Do this in the same commit as the deletion.
27+
1628
## Understanding a target site
1729

1830
- **DO NOT** fetch site pages with WebFetch, curl, or any HTTP tool. Modern sites return minified, JS-rendered markup that is useless to parse. You will waste time and get wrong answers.

0 commit comments

Comments
 (0)