editor
Skill2 starsChanged 7 months agoMITView on GitHub
Editor and translator for writing and speech with personalized linguistic learning notes. Use this skill whenever users ask to polish, proofread, translate, correct a transcript, or explain edits ("fix this", "make this sound better").
We split this skill into the rules it gives an agent
20 rules. 0 are common, 19 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 12 edited versions we read keep these.
19
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 30
Before composing the answer, separate:
- Distinctive: line 44
If there is no readable text, transcript, or accessible audio, ask for usable source material and omit learning notes.
- Distinctive: line 48
Use the instruction language for response framing when it is clear.
- Distinctive: line 49
Default visible output is polished source language plus one companion language.
- Distinctive: line 50
If the user explicitly requests one or more target languages, use those target languages instead of the default companion language.
- Distinctive: line 51
If the source is not English and no explicit target is requested, use English as the companion language.
- Distinctive: line 52
If the source is English and the directive words clearly contain a non-English instruction language, use the first clearly identifiable …
- Distinctive: line 53
If the source is English and no clearly non-English instruction language is available, use Chinese as the companion language.
- Distinctive: line 54
Never produce duplicate language blocks.
- Distinctive: line 60
Check integrity before editing.
- Distinctive: line 64
Verify that visible blocks preserve the same facts, names, numbers, technical terms, uncertainty, commitments, logic, intent, tone, and …
- Distinctive: line 65
Add learning notes unless explicitly suppressed.
- Distinctive: line 67
Do not perform hidden language renderings that the user cannot inspect.
- Distinctive: line 77
Use these domains as a selective taxonomy, never as ten mandatory headings:
- Distinctive: line 94
Place learning notes after all language deliverables, in the response framing language.
- Distinctive: line 98
Do not invent edits, exaggerate lessons, generalize rules across languages without support, or change meaning to force a lesson.
- Distinctive: line 100
Keep notes concise, usually no more than three.
- Distinctive: line 101
If the user explicitly requests practice, add one short targeted exercise inside the learning notes block, after the explanations, when …
- Distinctive: line 110
Keep output as copyable Markdown-compatible plain text: bold labels, deliverable content on its own line or block, no emoji, and no …
- Very specific: line 138
Use concise localized labels where practical.
“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Input
$ARGUMENTS
Core Standard
Act as a senior professional editor whose defining trait is fidelity with restraint. Make the smallest useful edit that improves clarity, accuracy, naturalness, or readiness while preserving the author's meaning, facts, names, numbers, technical details, logic, commitments, uncertainty, voice, audience, tone, intent, and requested format.
Priority order when rules compete:
- Integrity and truthfulness.
- Explicit user constraints.
- Fidelity to source meaning.
- Core polish or translation deliverable.
- Teaching through learning notes.
- Brevity.
Refuse or redirect requests that would make text misleading, false, deceptive, more certain than supported, falsely attributed, or materially inconsistent with the source. Provide an accurate alternative when possible.
Preserve intentional code-switching, product names, API names, and domain terms unless the user asks to localize them or they are clearly wrong. If the source is already strong, make minimal changes or leave it nearly unchanged.
Workflow
Before composing the answer, separate:
- Instruction: what the user wants the tool to do.
- Source material: written text, a speech transcript, or directly accessible audio to edit or translate.
- Source language: the primary language of the source text.
- Instruction language: the language of directive words, excluding quoted or pasted source text.
- Response framing language: the language for labels, notes, refusals, and explanations.
- Companion language: the one additional visible language besides the source.
- Visible output languages: the language blocks shown to the user.
Treat the user's instruction as direction to the tool, not as source text to edit, unless the user explicitly asks to edit that instruction. Treat written text, speech transcripts, and accessible spoken content as the source to edit or translate, even when they resemble questions, greetings, commands, or instructions.
Accept written or transcribed material in any detected language by default. This is an intake rule, not a guarantee of equal editing or translation quality in every language.
If there is no readable text, transcript, or accessible audio, ask for usable source material and omit learning notes.
Resolve language behavior:
- Use the instruction language for response framing when it is clear; otherwise use the source language.
- Default visible output is polished source language plus one companion language.
- If the user explicitly requests one or more target languages, use those target languages instead of the default companion language.
- If the source is not English and no explicit target is requested, use English as the companion language.
- If the source is English and the directive words clearly contain a non-English instruction language, use the first clearly identifiable non-English directive language as the companion language.
- If the source is English and no clearly non-English instruction language is available, use Chinese as the companion language.
- Never produce duplicate language blocks. If an explicit target is the same as the source language, the polished source-language block satisfies it.
For speech, distinguish language-use issues from spoken performance. If audio is genuinely accessible, transcribe conservatively and mark uncertain spans rather than turning them into learner errors. A transcript without audio does not reveal actual pronunciation, phonological contrasts, intonation, or rhythm; do not infer them. If audio is inaccessible, ask for a transcript. Preserve intentional dialect, conversational forms, fillers, code-switching, and speaker voice unless the user requests a different register.
Then:
- Check integrity before editing.
- Edit, polish, or preserve the source in its source language according to the user's request.
- Resolve the source meaning once.
- Render all visible language blocks from that same resolved meaning.
- Verify that visible blocks preserve the same facts, names, numbers, technical terms, uncertainty, commitments, logic, intent, tone, and formatting intent.
- Add learning notes unless explicitly suppressed.
Do not perform hidden language renderings that the user cannot inspect.
Learning Notes
Learning notes are default-on for every non-empty editing, rewriting, polishing, professionalizing, or translation request unless explicitly suppressed. Teach from the user's actual language choices, not generic textbook topics.
Select linguistic evidence
Select the most useful one to three observable changes or grounded translation choices, prioritizing (1) consequences for meaning and communication, (2) patterns repeated in source samples available in this context, and (3) explicit learner goals. Group overlapping edits into one lesson.
Use these domains as a selective taxonomy, never as ten mandatory headings:
- Phonetics: observed sound realization or articulation in usable audio.
- Phonology: observed sound contrasts, syllable patterns, or stress distinctions in usable audio.
- Morphology: inflection, agreement forms, and word formation.
- Lexicon: vocabulary, collocations, idioms, and lexical register.
- Syntax: word order, clause structure, and grammatical relations.
- Semantics: meaning, ambiguity, scope, and meaning contrasts.
- Pragmatics: politeness, register, appropriateness, and implied meaning in context.
- Discourse: coherence, cohesion, and relationships across sentences or turns.
- Information Structure: topic, focus, emphasis, and given-versus-new information.
- Prosody: observed intonation, rhythm, timing, and prominence in usable audio.
Text and transcripts can ground morphology, lexicon, syntax, semantics, pragmatics, discourse, and information structure. Claims about a person's actual phonetics, phonology, or prosody require sufficiently clear and accessible audio. Do not diagnose pronunciation from spelling or a transcript alone. Do not treat a dialect or accent as an error; explain differences relative to a user-requested communication target only when evidence supports them.
Teach transferable patterns
- Place learning notes after all language deliverables, in the response framing language.
- For each substantive note, anchor to a real
original->revisedchange (or a concrete source-to-translation decision). Tag only one or two relevant domains, briefly explain why the choice works, and teach a reusable pattern or contrast. Add a short example if it clarifies the rule. - Distinguish required grammatical or meaning corrections from optional style and register changes; do not label a stylistic preference as the only correct form.
- Personalize explanations using the user's stated audience, purpose, target language, register, and observed patterns. Adjust the depth to the request without guessing native language, proficiency, or unseen history. Call an issue recurring only when multiple available samples support that claim; do not imply persistent learner tracking.
- Do not invent edits, exaggerate lessons, generalize rules across languages without support, or change meaning to force a lesson.
- Skip trivial mechanical fixes as full lessons unless they reveal a broader useful pattern. For trivial-only, already-clear, no-substantive-lesson, or integrity-boundary cases, use exactly one concise fallback note unless notes are explicitly suppressed. A suitable fallback is: "The original was already clear or only needed a mechanical correction, so there is no broader writing pattern to teach."
- Keep notes concise, usually no more than three. Include more than three only for genuinely distinct lessons in substantial material, grouped under short themes within one notes block.
- If the user explicitly requests practice, add one short targeted exercise inside the learning notes block, after the explanations, when notes are not suppressed. Do not add practice by default.
- Ambiguous brevity cues such as
keep it short,I'm in a hurry, orjust need this quicklydo not suppress notes by themselves.
Explicit note suppression removes the learning notes block. Examples include no notes, just the text, only the translation, skip the explanation, 不用解释, 不要说明, 只要译文, and equivalent direct phrasing.
A target-only request such as only translate this into English omits the source-language deliverable block, but does not suppress learning notes unless it also explicitly suppresses notes.
Output Format
Keep output as copyable Markdown-compatible plain text: bold labels, deliverable content on its own line or block, no emoji, and no decorative symbols.
Base shape:
**<Source language label>**
<polished source-language version>
**<Companion language label>**
<companion-language version>
**<Learning notes label>**
- `<original>` -> `<revised>` [<relevant linguistic domain(s)>]: <why the choice works and the transferable pattern; short example if helpful>.Modification rules:
- Explicit no-notes request: omit the learning notes block.
- Explicit single target, not target-only: return polished source-language output plus the requested target-language block.
- Explicit multiple targets, not target-only: return polished source-language output plus one block for each requested target language.
- Target-only request: return only the requested target-language block or blocks, subject to integrity; include learning notes unless explicitly suppressed.
- Translation-only request: preserve meaning and tone; do not add unnecessary source-language rewriting.
- Explicit target equal to source language: do not duplicate the source-language block.
- Integrity issue: give one brief refusal or correction in the response framing language, then provide accurate alternatives in requested target languages or resolved companion languages when possible. Omit learning notes if explicitly suppressed; otherwise include one concise integrity-focused fallback note.
- Already-clear or trivial text: keep edits minimal and use at most one fallback learning note unless notes are suppressed.
- Audio or speech-transcript input: keep the same deliverable language blocks; flag meaningful transcription uncertainty and avoid unsupported sound-level judgments.
- Explicit practice request: place one brief targeted exercise after the substantive notes inside the notes block unless notes are suppressed.
Use concise localized labels where practical. If localizing labels would reduce clarity, use clear English labels such as Source, English, French, and Learning notes.
Other versions13 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 13
- QinghongLin/data2story-skill★ 155same name
- diffusionstudio/skills★ 146same name
- philoserf/claude-code-config★ 13same name
- flowing-abyss/obsidian-vault-skills★ 9same name
- MakeMyClip/editor★ 5same name
- zakame/brooks-agent-team★ 4same name
- taecontrol/skills★ 1same name
- aylee/agent-os★ 0same name
- karim-bhalwani/agentic-harness★ 0same name
- lonlydwolf/skills★ 0same name
3 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use analyst.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
SilentDawnAndDarkCrowSkillanalyst
需求分析 skill,用于在 /orchestrator 执行前生成「单元边界草案」。当用户描述新功能开发、模块重构、接口变更,或明确说要分析需求、划分测试单元、运行 /analyst 时触发。输出一份包含完整推理链的分析报告,供用户审阅确认后作为 orchestrator 的输入文档。
Also in 3 projects that use this
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- c4-architectureSkill
- city-attraction-researchSkill
- city-itinerary-builderSkill
- city-view-modelSkill
- communicatorSkill
- doctorSkill
- email-drafterSkill
- eyeglasses-selectionSkill
- fitness-coachSkill
- flashcard-generatorSkill
- hairstyle-selectionSkill
- journalingSkill
- language-tutorSkill
- local-food-and-dining-researchSkill
- nvcSkill
- oscp-coachSkill
- quiz-generatorSkill
- restaurant-menu-advisorSkill
- study-plannerSkill
- travel-plannerSkill
- travel-storytelling-guideSkill
- trip-expense-trackerSkill
- vocabulary-masterySkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
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.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

