Agent skill

Monthly Newsletter

by socialincome-san in socialincome-san/public

Builds Social Income's monthly newsletter HTML (website/emails/newsletter/YYYY-MM-newsletter.html) from the latest entry in the "Proofreading" tab of the Monthly Updates Google Doc.

Custom licenceAuto-check passedWriting & Content

Install Monthly Newsletter

skills CLI
$ npx skills add socialincome-san/public --skill monthly-newsletter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install socialincome-san/public monthly-newsletter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/socialincome-san/public.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/monthly-newsletter .claude/skills/monthly-newsletter && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
monthly-newsletter
GitHub stars
160
Token cost
~2.6k tokens
SKILL.md length
1,477 words
Files
3 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

Builds Social Income's monthly newsletter HTML (website/emails/newsletter/YYYY-MM-newsletter.html) from the latest entry in the "Proofreading" tab of the Monthly Updates Google Doc.

  • Works in 6 steps: Work out the target month → Get the text from the Google Doc → Numbers → …
  • Tasks that involve Newsletters
  • SKILL.md covers 1. Work out the target month, 2. Get the text from the…, 3. Numbers and 4. Map the doc to the HTML, plus 2 more sections
  • Runs Python scripts from its folder; calls python3 and jq

What it does

Monthly Newsletter is an agent skill from socialincome-san/public. Builds Social Income's monthly newsletter HTML (website/emails/newsletter/YYYY-MM-newsletter.html) from the latest entry in the "Proofreading" tab of the Monthly Updates Google Doc. Use this whenever someone wants to create, build, port, update or fill in the newsletter / monthly update / "Update" email for a month, move the proofread text into HTML, or works on a branch like aurelie/YYYY-MM-newsletter — even if they just say "do the November one" or "the text is ready".

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/outline.py` and `scripts/preview.py`).

It sits in Writing & Content, covering Newsletters, Copy editing and proofreading and Cloud office suites. It works with Google Docs, Firebase, Cloud Firestore and Storybook. The repository describes itself as: Fighting global poverty with the help of everyday people and your coding skills. Public repository of the NGO and global initiative Social Income.

When your agent uses it

  • Tasks that involve Newsletters
  • Tasks that involve Copy editing and proofreading
  • Tasks that involve Cloud office suites

Example prompts

  • “Proofreading”
  • “Update”
  • “do the November one”
  • “/monthly-newsletter”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Work out the target month
  2. Get the text from the Google Doc
  3. Numbers
  4. Map the doc to the HTML
  5. Check
  6. Report

What it can do on your machine

Read from SKILL.md and the folder at commit ed6b09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Monthly Newsletter loads about 2.6k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 1,477 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,477 words (~2,557 tokens).

“Each month Aurélie writes the newsletter in a Google Doc. After editing and proofreading, the text goes into a hand-built HTML email that is sent via SendGrid and archived in this repo. This skill does that port: doc → HTML.”

— opening of SKILL.md by socialincome-san, Custom licence
name
monthly-newsletter

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in .agents/skills/monthly-newsletter of socialincome-san/public.

  • SKILL.md
  • scripts/outline.py
  • scripts/preview.py

Open the folder on GitHubat commit ed6b09d

Compare with similar skills

Monthly Newsletter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Monthly Newsletter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Monthly Newsletter this skillsocialincome-san/public160—~2.6kAutomated safety check: PassCustom licence
DaleuiDaleStudy/daleui119—~675Automated safety check: PassMIT
Gws Workflow Weekly Digestgoogleworkspace/cli31k—~281Automated safety check: PassApache-2.0
Publishingdanjdewhurst/story-skills2861 repos~4.2kAutomated safety check: NotesMIT
Reader Paneldanjdewhurst/story-skills2861 repos~3.5kAutomated safety check: NotesMIT
Simple History Voicebonny/WordPress-Simple-History317—~775Automated safety check: PassNone

Similar skills

  • Daleui

    DaleStudy/daleui

    Use the daleui React design system with semantic Panda CSS tokens and accessible components.

    119 GitHub stars~675 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Gws Workflow Weekly Digest

    googleworkspace/cli

    Google Workflow: Weekly summary: this week's meetings + unread email count.

    31k GitHub stars~281 tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Publishing

    danjdewhurst/story-skills

    This skill should be used when the user asks to "self-publish", "publish my book", "ISBN", "copyright page", "book metadata", "BISAC", "keywords", "KDP", "IngramSpark", "Draft2Digital", "go wide"…

    286 GitHub starsUsed in 1 repo~4.2k tokens
    Writing & ContentAuto-check: notes
  • Reader Panel

    danjdewhurst/story-skills

    This skill should be used when the user asks for a "simulated beta read", "reader panel", "persona read", "first read before my beta readers", "how would a genre reader react", "would a reader keep…

    286 GitHub starsUsed in 1 repo~3.5k tokens
    Writing & ContentAuto-check: notes
  • Simple History Voice

    bonny/WordPress-Simple-History

    Pär's writing voice and per-text-type rules for Simple History, on top of the humanizer skill.

    317 GitHub stars~775 tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Personal Chinese Writing Style

    sugarforever/01coder-agent-skills

    Apply the user's Chinese writing style when writing, translating, editing, proofreading, polishing, or publishing Chinese content, including blog posts, articles, subtitles, captions, tweets/X…

    137 GitHub stars~744 tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed

Questions about Monthly Newsletter

What does Monthly Newsletter do?

Builds Social Income's monthly newsletter HTML (website/emails/newsletter/YYYY-MM-newsletter.html) from the latest entry in the "Proofreading" tab of the Monthly Updates Google Doc. Monthly Newsletter is an agent skill from socialincome-san/public.html) from the latest entry in the "Proofreading" tab of the Monthly Updates Google Doc.

When should I use Monthly Newsletter?

Monthly Newsletter fits situations like: tasks that involve Newsletters; tasks that involve Copy editing and proofreading; tasks that involve Cloud office suites.

How do I install Monthly Newsletter in Claude Code?

Run `npx skills add socialincome-san/public --skill monthly-newsletter -a claude-code`. Or copy the skill folder (.agents/skills/monthly-newsletter in socialincome-san/public) into .claude/skills/monthly-newsletter in your project. Claude Code loads it when a task matches its description.

How do I install Monthly Newsletter in Codex?

Run `npx skills add socialincome-san/public --skill monthly-newsletter -a codex`. Or copy the skill folder (.agents/skills/monthly-newsletter in socialincome-san/public) into .agents/skills/monthly-newsletter in your project. Codex loads it when a task matches its description.

Can I use Monthly Newsletter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add socialincome-san/public --skill monthly-newsletter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/monthly-newsletter, .gemini/skills/monthly-newsletter, .github/skills/monthly-newsletter and .opencode/skills/monthly-newsletter in your project.

What does Monthly Newsletter need to run?

Going by SKILL.md and its folder, Monthly Newsletter needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and jq). Our summary lists: Python 3.

Does Monthly Newsletter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Monthly Newsletter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Monthly Newsletter use?

Monthly Newsletter has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Monthly Newsletter use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Monthly Newsletter?

Skills that share tags, products or a category with Monthly Newsletter: Daleui (DaleStudy/daleui, 119 stars), Gws Workflow Weekly Digest (googleworkspace/cli, 31k stars), Publishing (danjdewhurst/story-skills, 286 stars) and Reader Panel (danjdewhurst/story-skills, 286 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Monthly Newsletter?

socialincome-san (a GitHub organization) maintains it in socialincome-san/public, which has 160 GitHub stars. The repository was last updated on October 11, 2026.

Source: socialincome-san/public on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.