agentleFS
seankoji-comseankoji-com/.agents/skills/github-writing/SKILL.md

github-writing

Skill2 starsChanged 9 days agoMITView on GitHub

Use whenever drafting or editing LLM-written GitHub issues, pull requests, comments, reviews, discussions or release notes on the user's behalf.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. SgtPooki/skills★ 1same name
    2. h-wata/claude-skills★ 0same name

    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.

  • In this repository15 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Start each new prose body with this GitHub NOTE block, followed by a blank line.

    line 38
  2. Distinctive:

    Put the NOTE immediately before each added or rewritten passage.

    line 67
  3. Distinctive:

    Use prose bodies, not titles or metadata fields, for bylines.

    line 77
  4. Distinctive:

    When explicitly setting a merge commit message, follow commit policy without injecting this prose byline.

    line 80
  5. Distinctive:

    Do not add private session links, prompts, transcripts, credentials or machine paths.

    line 86
  6. Distinctive:

    Before an authorised write, check the repository's contribution and AI-use rules and required format.

    line 92
  7. Distinctive:

    Read back each created or edited body and verify the content and byline are present, correctly attributed and not duplicated.

    line 102
  8. Distinctive:

    Use the caller's existing authority and submission procedure.

    line 109

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Disclose AI-written GitHub prose

Identify the writer

Apply this to prose bodies and replies, including inline review comments and updates to existing text. Keep repository templates, factual evidence and human text. The byline identifies who wrote the prose, separately from who wrote or reviewed the code and which account submits it.

Identify the actual writing model from host-reported identity or the delegated writer's verified report. Briefs label the dispatch target as expected identity; the writer confirms its active host-reported identity, which takes precedence. Report any mismatch. Use the known model/version; do not infer it from the harness, provider alias or API account. Record unknown identity explicitly. Credit each model that materially wrote the retained prose. A coordinator that only posts another model's draft is not its writer. A reviewer belongs in the existing review attribution, unless it also wrote retained prose. For multiple agents, new assertions, reasoning or substantially rewritten wording earn writer credit. Formatting, link fixes, template placement and light copy edits alone do not add another writer.

Identify the represented operator from the request and standing instructions, using authenticated account evidence to verify the handle. Do not hard-code the library owner's handle for another user or infer representation from repository ownership. When the user directs the write and the posting account is verified as theirs, use that login as the operator. A bot or shared account's login alone does not identify the represented human. If the operator is unknown, omit the on-behalf-of clause. If the model is unknown, use "an AI assistant, model identity unavailable" instead of guessing.

Add a visible byline

Start each new prose body with this GitHub NOTE block, followed by a blank line. Preserve its Markdown and substitute the verified writer and operator:

> [!NOTE]
> _Written by **GPT-6.1 Sol** on behalf of @seankoji_

For multiple writing models, name each in bold in first-contribution order, using commas and a final "and". For example:

> [!NOTE]
> _Written by **Claude Opus 5.5** and **GPT-6.1 Sol** on behalf of @seankoji_

The chosen format authorises mentioning the verified operator, including when a bot posts. It authorises no other mentions or notifications. Carry the writer identities and this skill's path in delegated writing assignments and returns. The parent preserves those identities when posting or merging drafts.

For a rewrite, move the applicable AI byline to the top of its scope and update it once, preserving still-applicable writer credits and human signatures. In a wholly AI-written body, put the NOTE before the body and its template headings. Preserve required headings and checklist answers. If a required repository format conflicts with this placement, preserve the draft and report the conflict.

In a mixed human/AI body, section scope takes precedence over that placement. Put the NOTE immediately before each added or rewritten passage. Follow it with a plain scope sentence, such as "This byline covers only the Verification section below." Keep the NOTE wording unchanged. Distinct passages may have distinct bylines; they are not duplicates. Preserve untouched human text and historical evidence without attributing it to a model.

A top-level > [!NOTE] byline counts as disclosure. An example inside a code fence or nested quotation such as > > does not. On retries and updates, reconcile the byline for the same passage instead of appending it again.

Use prose bodies, not titles or metadata fields, for bylines. A bodyless or metadata-only action does not require a new comment solely to add a byline. Git commit messages and code co-author trailers retain their existing policies. When explicitly setting a merge commit message, follow commit policy without injecting this prose byline. A repository's existing squash default may copy the PR body and its byline; that is not a change to commit policy or reason to rewrite history. This rule applies to newly drafted or edited text, not a bulk rewrite of old posts.

Do not add private session links, prompts, transcripts, credentials or machine paths. Do not claim human review or approval unless it actually occurred. The byline does not replace the PR's contributor roles, scopes or review outcomes.

Verify the outgoing text

Before an authorised write, check the repository's contribution and AI-use rules and required format. Reuse applicable policy evidence already obtained by the calling workflow. If the destination forbids the submission or required disclosure, preserve the draft and report the conflict rather than silently removing the byline or disguising AI involvement.

GitHub closes an issue referenced after a closing keyword (close, fix, resolve and their variants), even in a negated sentence. Use those keywords only for issues the change resolves; refer to others neutrally, such as "#N stays open".

Read back each created or edited body and verify the content and byline are present, correctly attributed and not duplicated. Reconcile an uncertain write before retrying. A read-back failure remains a verification gap, not permission to repost. A draft includes the byline but is still a draft.

Beyond the required operator mention, this skill grants no authority to post, notify people, approve a PR, change metadata or share private material. Use the caller's existing authority and submission procedure.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.