Skip to content

Commit b38bbf5

Browse files
Add announcement drafts
1 parent adfed58 commit b38bbf5

1 file changed

Lines changed: 142 additions & 0 deletions

File tree

docs/announcements.md

Lines changed: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
1+
# Announcement Drafts
2+
3+
## GitHub Discussion (community-digest-action)
4+
5+
**Title:** Introducing community-digest-action v0.1
6+
7+
---
8+
9+
A drop-in GitHub Action that posts a weekly digest to Discussions. Merged PRs, new contributor shoutouts, zero config spam.
10+
11+
### What it does
12+
13+
- Posts a clean markdown digest every week (or on-demand)
14+
- Lists merged PRs with author links
15+
- Shouts out first-time contributors
16+
- Skips posting when there's nothing to report (anti-spam)
17+
18+
### Why this exists
19+
20+
Newsletters are work. Release notes get stale. Discussions go quiet.
21+
22+
This action runs on a cron, collects the week's activity, and posts a summary. Your community stays informed without you doing anything.
23+
24+
### Quickstart
25+
26+
```yaml
27+
- uses: malmichaels-gif/community-digest-action@v0
28+
with:
29+
discussion_category: "Announcements"
30+
```
31+
32+
That's it. See the [README](https://github.com/malmichaels-gif/community-digest-action) for config options.
33+
34+
### Good first issues
35+
36+
Looking to contribute? Start here:
37+
38+
1. **Docs:** Improve the "How it decides to skip" section
39+
2. **Feature:** Add optional "Issues closed" section (v0.2)
40+
3. **UX:** Better error message when Discussion category doesn't exist
41+
42+
---
43+
44+
## GitHub Discussion (agent-instructions-kit)
45+
46+
**Title:** Introducing agent-instructions-kit v0.1
47+
48+
---
49+
50+
A CLI + GitHub Action for maintaining AGENTS.md and CLAUDE.md files.
51+
52+
### What it does
53+
54+
- `init` — generates template files (minimal or opinionated)
55+
- `check` — validates required sections exist
56+
- `safety` — lints for prompt injection patterns and sketchy instructions
57+
58+
### Why this exists
59+
60+
Agent instruction files are becoming normal. But they drift, get copy-pasted from sketchy sources, and sometimes contain "ignore previous instructions" garbage.
61+
62+
This kit keeps your repo's agent instructions consistent and harder to hijack.
63+
64+
### Quickstart
65+
66+
```bash
67+
npx agent-instructions-kit init
68+
npx agent-instructions-kit check
69+
npx agent-instructions-kit safety
70+
```
71+
72+
Or add to CI:
73+
74+
```yaml
75+
- uses: malmichaels-gif/agent-instructions-kit@v0
76+
with:
77+
mode: "all"
78+
```
79+
80+
See the [README](https://github.com/malmichaels-gif/agent-instructions-kit) for details.
81+
82+
### Good first issues
83+
84+
1. **Template:** Add a template section for "Forbidden actions"
85+
2. **Safety rule:** Detect "upload to pastebin" patterns
86+
3. **Docs:** Add examples of real-world AGENTS.md files
87+
88+
---
89+
90+
## X Post (community-digest-action)
91+
92+
**Option A (direct):**
93+
```
94+
Shipped: community-digest-action
95+
96+
A GitHub Action that posts weekly digests to Discussions. Merged PRs, new contributor shoutouts, skips when nothing happened.
97+
98+
Drop-in. No AI. No newsletter editor.
99+
100+
github.com/malmichaels-gif/community-digest-action
101+
```
102+
103+
**Option B (slightly edgier):**
104+
```
105+
Your repo doesn't need a newsletter.
106+
107+
It needs a weekly digest that writes itself.
108+
109+
Shipped community-digest-action — merged PRs, new contributors, zero config spam.
110+
111+
github.com/malmichaels-gif/community-digest-action
112+
```
113+
114+
---
115+
116+
## LinkedIn Post (community-digest-action)
117+
118+
```
119+
Shipped a small open-source project: community-digest-action
120+
121+
It's a GitHub Action that posts a weekly digest to your repo's Discussions tab. Merged PRs, first-time contributor shoutouts, and it skips posting when there's nothing to report.
122+
123+
Why build this?
124+
125+
Most repos go quiet between releases. Contributors don't know what's happening. Maintainers don't have time to write newsletters.
126+
127+
This runs on a cron, collects the week's activity, and posts a summary. Your community stays informed without you doing anything.
128+
129+
Drop-in setup (one YAML file), no external services, no AI required.
130+
131+
Link: github.com/malmichaels-gif/community-digest-action
132+
133+
If you maintain an open-source project, give it a try. Feedback welcome.
134+
```
135+
136+
---
137+
138+
## Notes
139+
140+
- Screenshots: Add after first real digest posts (need PR activity)
141+
- Tone: Kept it clean and direct, no "excited to announce" or "game-changer"
142+
- CTA: Soft ask for feedback, not "star this repo"

0 commit comments

Comments
 (0)