agentleFS
tsubasaogawatsubasaogawa/skills/hacker-news-digest/SKILL.md

hacker-news-digest-ja

Skill0 starsChanged 32 days agoMITView on GitHub

Generate a Japanese digest for yesterday's Hacker News stories scoring over 100 points, matching the `main.py` workflow without `google-generativeai` or `GEMINI_API_KEY`. Use this skill when users ask for a daily HN digest, want top Hacker News posts translated and summarized in Japanese, or want the Gemini-based workflow replaced with a skill.

  • Reads credentials

The file

Show its rules and text

We split this skill into the rules it gives an agent

18 rules. About 0 are common, 9 are distinctive, and 9 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.

  • 9

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use this skill to reproduce the current main.py behavior in a reusable way, but rely on the model's own language abilities instead of …

    line 10
  2. Very specific:

    Do not ask for GEMINI_API_KEY.

    line 22
  3. Very specific:

    Read scripts/fetch_hn_stories.py to confirm the exact fetch logic.

    line 26
  4. Very specific:

    Prefer running uv run python skills/hacker-news-digest-ja/scripts/fetch_hn_stories.py from the repository root.

    line 27
  5. Very specific:

    If uv is unavailable, fall back to python3 skills/hacker-news-digest-ja/scripts/fetch_hn_stories.py.

    line 28
  6. Distinctive:

    If shell execution cannot reach the network, reproduce the script's exact URL and filters with the available web-fetching tool instead of …

    line 29
  7. Distinctive:

    Use the fetched stories as the source of truth.

    line 30
  8. Very specific:

    Keep original_title exactly as provided.

    line 32
  9. Very specific:

    Write a natural Japanese translation for japanese_title.

    line 33
  10. Very specific:

    Write a one-sentence Japanese summary for summary.

    line 34
  11. Distinctive:

    Use this exact header:

    line 39
  12. Very specific:

    If a story URL is missing, use # as the link target.

    line 55
  13. Distinctive:

    Keep the original title in the link text exactly as fetched.

    line 56
  14. Distinctive:

    Keep the summary to one Japanese sentence.

    line 57
  15. Distinctive:

    Do not prepend or append prose around the table unless the user explicitly asks for commentary.

    line 58
  16. Distinctive:

    Prefer concise, natural Japanese over word-for-word translation.

    line 62
  17. Distinctive:

    Do not invent details that are not supported by the title or obvious public context.

    line 64
  18. Distinctive:

    If the fetch step fails, report the error clearly instead of fabricating a digest.

    line 65

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

Hacker News digest in Japanese

Use this skill to reproduce the current main.py behavior in a reusable way, but rely on the model's own language abilities instead of Gemini.

Default scope

Unless the user explicitly asks for something else, keep the behavior fixed to match main.py:

  • Time window: yesterday in UTC, from 00:00:00 to the next 00:00:00
  • Source: https://hn.algolia.com/api/v1/search_by_date
  • Filters: tags=story, points>100
  • Page size: hitsPerPage=100
  • Output: a Markdown table in Japanese

Do not ask for GEMINI_API_KEY. Do not use google-generativeai.

Workflow

  1. Read scripts/fetch_hn_stories.py to confirm the exact fetch logic.
  2. Prefer running uv run python skills/hacker-news-digest-ja/scripts/fetch_hn_stories.py from the repository root.
  3. If uv is unavailable, fall back to python3 skills/hacker-news-digest-ja/scripts/fetch_hn_stories.py.
  4. If shell execution cannot reach the network, reproduce the script's exact URL and filters with the available web-fetching tool instead of changing the behavior.
  5. Use the fetched stories as the source of truth. Preserve the order returned by the API.
  6. For each story:
    • Keep original_title exactly as provided.
    • Write a natural Japanese translation for japanese_title.
    • Write a one-sentence Japanese summary for summary.
  7. Produce the final answer as a Markdown table and nothing else unless the user asks for extra commentary.

Output format

Use this exact header:

| タイトル (原文) | タイトル (日本語訳) | 概要 |
| :--- | :--- | :--- |

Then output one row per story in this shape:

| [Original title](url) | 日本語訳 | 1 文の要約 |

Formatting rules:

  • Escape any literal | inside cell text as |.
  • If a story URL is missing, use # as the link target.
  • Keep the original title in the link text exactly as fetched.
  • Keep the summary to one Japanese sentence.
  • Do not prepend or append prose around the table unless the user explicitly asks for commentary.

Quality bar

  • Prefer concise, natural Japanese over word-for-word translation.
  • Make summaries informative enough that the user can skim the table and understand why the post mattered.
  • Do not invent details that are not supported by the title or obvious public context.
  • If the fetch step fails, report the error clearly instead of fabricating a digest.

Typical trigger examples

  • "昨日の Hacker News の人気記事を日本語で一覧にして"
  • "main.py を Gemini なしで使える skill にしたい"
  • "HN の 100 点超え記事を訳して 1 行ずつ要約して"

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.