rendered-markdown
Use when a GitHub PR description, comment, or issue body looks broken: wrapped lines, bad code fences, long logs, links. Not for filing an issue.
- License 许可
- MIT
- 所属仓库
- tony/skills
- 最近更新
- 2026-11-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- rendered-markdown
- description
- Use when a GitHub PR description, comment, or issue body looks broken: wrapped lines, bad code fences, long logs, links. Not for filing an issue.
- allowed-tools
- [ "Read", "Write", "Bash" ]
- disallowed-tools
- [ "Edit" ]
02 资源文件 1
- 参考文档agents/openai.yaml261 B
03 SKILL.md 正文
Rendered markdown
Write the body so it renders, and link it so it still resolves in
three years. Write it per ../../references/prose-rules.md.
Read ../../references/rendered-markdown.md before drafting. When the text
has links, also read ../../references/source-links.md and
../../references/source-pins.md; when it names an upstream open-source
project, ../../references/project-links.md. For a pull-request
description or a repository markdown file, also read
../../references/pr-and-files.md.
Steps
-
Identify the surface (comment, issue, or pull-request body; repository file). Read the project's
AGENTS.mdandCLAUDE.mdwhen present: a house voice, slop rubric, or table rule there overrides these references (not link pinning or the sanitize step). A wrap convention applies only to repository files (seepr-and-files.md). -
Get the text. The script is
../../scripts/issue.py; it resolves from this skill's directory to an absolute path written literally in each command, andscanandlintare documented in its docstring (its other subcommands servecreate-issue). When the text is already on GitHub, fetch it from its issue, pull-request, or comment URL; writing the fixed text back is the user's call:$ python3 /absolute/path/to/scripts/issue.py fetch URL -
Draft or fix the text per
rendered-markdown.md; pin and complete every link per the link references. -
Run "Preview before publishing" in
rendered-markdown.mdwith that script. Without a shell, reread by eye. A0 lengthrow means trim the excerpt and link the full log (Length in that reference). Leave a table in someone else's body alone.
Reply
A status line (repository, and whether the preview ran), the rewritten body fenced with four backticks, then one sentence naming what the user must do before posting. No bullet list, command, or explanation of what changed.
Rewritten body for example/widgets, preview not run (gh is not logged in).
````markdown
The retry loop drops the timeout on the third attempt.
<details>
<summary>Full stack trace</summary>
```
TypeError: Cannot read properties of undefined (reading 'target')
```
</details>
See [`src/build.js`](https://github.com/example/widgets/blob/<SHA>/src/build.js#L38-L50).
````
Before posting, replace `<SHA>` with the commit where you saw the bug, or a release tag.
If the text cannot be fixed (no body was given, or the surface is a commit message), reply with one sentence saying so and what the user should send.
04 同仓库更多 Skills
serene-bliss
Use when asked to make a CLI --help, docs page, error message, or tooling UX more serene or calmer for developer experience; returns text, no edits.
review
Weave code review: run independent adversarial reviews in parallel, then synthesize findings
refine
Use when asked to refine a draft, iterate on code until cleaner, or polish a README through repeated critique and improvement.
prompt
Weave prompt: compare independent adversarial implementations, then adopt the single best one
plan
Weave planning: compare independent adversarial plans, then synthesize the best one
fix-review
Fix weave review findings: validate, add test coverage, fix, and commit each as atomic changes