agentleFS
AloisSeckarAloisSeckar/demos-java/.agents/skills/article-add/SKILL.md

article-add

Skill25 starsChanged 7 days agoUnlicenseView on GitHub

Add one or more articles, releases, or announcements as new entries to JavaNews.md in demos-java. Use when the user provides URLs to add to the Java news list.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. petestewart/claude-skills★ 2same 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 repository4 other files it gives its agents.

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. About 0 are common, 9 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only edit that file. Do not create other files or notes.

    line 10
  2. Very specific:

    Use backticks for code identifiers, e.g.

    line 22
  3. Distinctive:

    Use the original article URL exactly as the user gave it (do not add tracking parameters or rewrite it).

    line 23
  4. Very specific:

    Read the current month sections at the top of JavaNews.md after fetching.

    line 29
  5. Distinctive:

    Use the real publication date, in this order of preference:

    line 36
  6. Distinctive:

    If the date cannot be determined, ask the user.

    line 43
  7. Distinctive:

    Put each entry into the section of its own month, which is not necessarily the current one (for example, a late August article added in …

    line 56
  8. Distinctive:

    If the month section does not exist yet, create it directly above the newest existing month section, copying the header above.

    line 58
  9. Very specific:

    If the date belongs to a year other than the one in the file's sections, ask the user before touching archive files (JavaNews2025.md, etc.).

    line 60
  10. Very specific:

    After the edit, check that no existing row changed (for example, by grepping a neighbouring row).

    line 67
  11. Distinctive:

    Do not add a row for a URL that is already in the file.

    line 69
  12. Distinctive:

    If a fetch redirects to an unrelated (ad or tracking) domain, do not follow it.

    line 74
  13. Distinctive:

    If the date is also unknown, ask for it before adding the row.

    line 77

≈ “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

Add Articles to JavaNews.md

Input: one or more URLs (/article-add <url1> <url2> ...). Each URL becomes one table row in JavaNews.md. Only edit that file. Do not create other files or notes.

Entry format

| **`YYYY-MM-DD`** | [Article Title](URL) - short description with **bold** key terms |
  • Title: the article's own title. Shorten only if it is very long or clickbaity.
  • Description: one sentence, after -, in a neutral informative tone. No emojis, no marketing wording, no opinions of your own. Say what the article announces or explains.
  • Bold (**...**) the key product, project, release, or JDK version, e.g. **JDK 28**, **Quarkus**, **WildFly 42**. Use backticks for code identifiers, e.g. `HttpClient`.
  • Use the original article URL exactly as the user gave it (do not add tracking parameters or rewrite it).

Workflow

  1. Fetch all URLs in parallel. Ask for the title, publication date, author, and a content summary.
  2. Determine the date of each article (see below). Never guess it.
  3. Read the current month sections at the top of JavaNews.md after fetching. The user edits this file by hand (shortening descriptions, fixing typos), so always work from the current content, not from memory.
  4. Insert the rows (see placement below) with a single edit per file where possible.
  5. Report briefly: one line per article with its date and the section it went to, plus any caveat.

Determining the date

Use the real publication date, in this order of preference:

  • The byline or date shown on the page (InfoQ, JavaPro, Foojay, inside.java, WildFly, Quarkus, TornadoVM, InfoWorld, ...). The date in the URL may be wrong or only approximate (for example, a Foojay URL can differ from its byline date).
  • GitHub release pages show relative dates ("2 weeks ago"). Fetch https://api.github.com/repos/<owner>/<repo>/releases/tags/<tag> and use published_at.
  • Mailing-list announcements (mail-archive.com): use the date in the message header.
  • If the date cannot be determined, ask the user. Do not invent one. If the user supplies it later, add the entry then.

Placement

  • Entries are grouped in ## YYYY - Month sections, newest section first, each with the same table header:

    ## 2026 - October
    
    | Date&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Article |
    | --- | :-- |
  • Put each entry into the section of its own month, which is not necessarily the current one (for example, a late August article added in September goes to August).
  • If the month section does not exist yet, create it directly above the newest existing month section, copying the header above.
  • Within a section, order rows by date, newest first. For equal dates, add the new row next to the existing rows of that date.
  • If the date belongs to a year other than the one in the file's sections, ask the user before touching archive files (JavaNews2025.md, etc.).
  • The file may already contain a few out-of-order rows. Do not reorder or reformat existing rows.

Safe editing

  • Match the existing text exactly in the old-string of the edit, and copy every unchanged row verbatim into the new string. After the edit, check that no existing row changed (for example, by grepping a neighbouring row). Past mistake: rewording **Java 28** to **JDK 28** in an unrelated row. Fix such slips immediately.
  • Do not add a row for a URL that is already in the file. Tell the user instead.

When a page cannot be read

  • Cookie walls and long boilerplate are normal. Look for the article body, byline, and date in the fetched text.
  • If a fetch redirects to an unrelated (ad or tracking) domain, do not follow it. Retry once, then try one alternative source (the project's own site or API). If the content is still unavailable, say so.
  • Without readable content, write the description only from what is verifiable (for example, the title) and tell the user. If the date is also unknown, ask for it before adding the row.

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.