compass-skills

What the source does

• FilesystemDeclared1 observation
• NetworkDeclared4 observations
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

<script type="application/json" id="i18n-en">{"0. 为什么需要":"0. Why skills","1. 最小模型":"1. Minimum model","1. 真实跑通":"1. Real run-through","1. 给目标":"1. Give goals","10. 迭代优化":"10. Iteration","11. 常见类型":"11

url = f"http://127.0.0.1:{port}/"

raw = base64.b64decode(encoded, validate=True)

JPEG_WITH_METADATA = base64.b64decode(

sanitized = base64.b64decode(payload["data_uri"].split(",", 1)[1])

assets/compass-logo.png

assets/compass-roadmap-ecosystem.en.png

assets/compass-roadmap-ecosystem.zh.png

assets/logo-variants/compass-logo-alien-artifact.png

assets/logo-variants/compass-logo-ceramic-minimalist.png

- If the user asks for a public/shareable handoff, run redaction and shareable validation first.

If the user asks for a public handoff, switch to `privacy=shareable`, redact local paths, and validate with:

- If the user asks for the onboarding questionnaire or first-run WebUI, run `scripts/onboarding_webui.py --user <id>`.

- No active profile exists: recommend the onboarding questionnaire. If the user asks for it, run the WebUI. If the user declines, continue with the current task and use proposals for any durable profi

If the user asks for the questionnaire or WebUI, run it. If the user declines, continue with the current task and create proposals for any durable candidates. Current-session AGENTS rules, skill opera

- Do not read password managers, keychains, SSH keys, browser cookies, API keys, tokens, or verification codes.

- [Verified] Do not read credentials, cookies, browser sessions, or unrelated private logs.

1. Store locally only. Do not upload anything or read browser cookies, tokens, or credentials.

- [Verified] Do not read credentials, cookies, browser sessions, or unrelated private logs.

1. Store locally only. Do not upload anything or read browser cookies, tokens, or credentials.

Audit 0.4.1 · source sha 220e40110f40 · 19 Oct 2026Report an issue or request a re-scan

• Publisherdongshuyan GitHub userOwner of the repository this skill is read from
• Source folderdongshuyan/compass-skillsThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict220e40110f40A new audit runs when the source changes
• Repository statusNot archivedPushed today
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Draft, audit, or minimally revise English- or Chinese-language academic prose to reduce formulaic, vacuous, mechanically repetitive, or process-leaking language while preserving claims, evidence strength, logical…

---
name: academic-humanizer
description: >-
  Draft, audit, or minimally revise English- or Chinese-language academic prose
  to reduce formulaic, vacuous, mechanically repetitive, or process-leaking
  language while preserving claims, evidence strength, logical relations,
  manuscript-wide terminology identity, document-level pattern variation, and
  scholarly register. Use for papers, abstracts, grants, cover letters, and
  reviewer responses when the user asks to de-AI, humanize, audit AI-like
  phrasing, or rewrite text without changing meaning. English is primary;
  Chinese is supported. Not for detector evasion, policy circumvention, pure
  translation, non-academic copy, or adding facts, citations, examples, or
  author experiences that the source does not contain.
---

# Academic Humanizer

Improve academic prose by removing observable writing defects, not by imitating
imperfection or optimizing an authorship detector. Preserve the author's facts,
argument, uncertainty, and disciplinary voice. This skill does not guarantee how
any reader or detector will classify a text.

## Portability

This skill is agent-agnostic. Its core behavior is defined by `SKILL.md` and
`references/`; Python is optional and supports reproducible diagnostics.

- Resolve `<skill-dir>` from the directory containing this `SKILL.md`.
- Let `<python>` mean an available Python 3 launcher, such as `python3`, `py -3`,
  or `python`.
- Let `<input-file>` mean a user-authorized local text file. Quote paths that
  contain spaces and use the host shell's path separator.
- Do not assume a fixed skill root, home directory, shell, operating system,
  agent name, or path separator.
- `agents/openai.yaml` is optional interface metadata. Core behavior does not
  depend on a particular agent runtime.
- If Python is unavailable, skip the scripts and apply the same contracts
  directly.

## Load the operating references

Read these before drafting or editing:

1. [Semantic contract](references/semantic-contract.md) for claim preservation,
   locked spans, deletion safety, and the internal claim ledger.
2. [Terminology contract](references/terminology-contract.md) for canonical terms,
   declared aliases, coined names, intentional distinctions, and the internal
   terminology ledger. Always load it for multi-span or manuscript-level work.
3. [Global pattern contract](references/global-pattern-contract.md) for the
   local-to-document audit, distribution map, scope limits, and whole-document
   repair. Always load it for multi-sentence work.
4. [Academic whitelist](references/whitelist-academic.md) for protected scholarly
   forms in both languages.
5. [Contrast logic](references/contrast-logic.md) for false-opposition triage in
   English and Chinese. Always load it; this is a cross-language semantic rule.
6. Route once by the majority language of editable prose, then read exactly one:
   [English rules](references/rules-en.md) or
   [Chinese rules](references/rules-zh.md).

Read [worked examples](references/examples.md) on first use, after changing a
rule, or whenever fact preservation, contrast, or over-correction is uncertain.
Read [metrics specification](references/metrics-spec.md) before running
`scripts/metrics.py`; its output is descriptive evidence only.

## Supported operations

- **generate**: draft from user-supplied claims, outline, data, and sources.
- **detect**: identify high-confidence defects without rewriting.
- **rewrite**: minimally revise supplied prose; this is the default when the user
  asks to de-AI or humanize text.
- **edit**: apply the same minimal revisions to a named file.

Do not create another routing tree for paper section or discipline. Methods,
Results, Discussion, reviewer responses, and grants use the same contracts; the
whitelist handles legitimate register differences. Ask one direct question only
when the requested genre changes what counts as acceptable and context does not
resolve it.

## Language route

Route on editable prose, excluding fenced code, formulas, block quotations, and
a trailing reference list. Use orthographic tokens: each CJK character is one
token and each contiguous Latin word is one token. This keeps embedded terms such
as `Transformer` or `ImageNet` from outweighing the Chinese sentence around them:

`r = CJK tokens / (CJK tokens + Latin word tokens)`

- `r >= 0.5`: Chinese branch.
- `r < 0.5`: English branch.
- No countable prose: stop and ask for text or an intended output language.

English terms in Chinese prose and Chinese terms in English prose remain
verbatim. If Python is available and the route is genuinely unclear, optionally
run `<python> "<skill-dir>/scripts/metrics.py" "<input-file>" --route`.
Routing is internal and never appears in the clean artifact.

## Single arbitration order

Earlier rows win. References may elaborate this table but must not define a
second priority order.

| Priority | Constraint | Operational meaning |
|---|---|---|
| **C0** | Artifact boundary | Process instructions, editor narration, and tool residue never enter the artifact. C0 applies only to process-layer text; it never authorizes deletion of real content. |
| **C1** | Semantic fidelity | Every output claim maps to the source bundle; every material source claim remains represented. No added facts, relations, examples, citations, motivations, or limitations. |
| **C2** | Locked-span protection | Quotations, formulas, code, references, citation keys, statistical notation, proper nouns, and requested verbatim text remain unchanged. |
| **C3** | Terminology identity | One scientific concept uses one canonical term across the editable manuscript. Preserve declared full-name/abbreviation pairs, necessary grammatical forms, and intentional distinctions; never infer identity from similarity alone. |
| **C4** | Academic register | Preserve functional hedging, passive voice, nominalization, discourse markers, and Chinese scholarly morphology. |
| **C5** | Argument structure | Pre

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-19
   !CAUTION B 89 / 100

   first audit · source 220e40110f40

Questions about compass-skills

• github.com/dongshuyan/compass-skills — the audited source at commit 220e40110f40 and every finding aboveObserved · 19 Oct 2026

Spotted something wrong? Report a correction · Methodology