Run any Skill in Manus with one click

reddit-mcp-post

Stars5

Forks0

UpdatedJune 6, 2026 at 15:18

Drafts a self-post for the [r/mcp](https://www.reddit.com/r/mcp) subreddit (Model Context Protocol community) in Markdown with a YAML frontmatter title and optional flair, then runs a script that strips the frontmatter, places the body markdown on the macOS clipboard via `pbcopy`, and prints the title and flair to stderr so the user can paste them into Reddit's title field, flair dropdown, and markdown editor. Use when the user asks to write, draft, polish, or post content explicitly intended for r/mcp — phrases like "post on r/mcp", "Show & Tell on r/mcp", "draft an MCP subreddit post", or "write a Reddit post for the MCP community".

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

richardwooding

richardwooding/file-search-on

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

5 files

SKILL.md

readonly

name

reddit-mcp-post

description

r/mcp Post

r/mcp is the subreddit for the Model Context Protocol — readers are agent developers, tool builders, and integrators who care about MCP servers, clients, and spec details. Reddit's post composer accepts markdown directly, so the script just splits the YAML frontmatter from the body and pipes the body to pbcopy.

Quick start

Gather from the user: project / topic, key technical points, repo URL, which MCP clients have been tested (Claude Desktop, Cline, Continue, Cursor, Zed, etc.), transport (stdio / Streamable HTTP / SSE), and post type (Show & Tell vs Discussion / Help).
Pick a template — templates/show-and-tell.md.tmpl for project announcements, templates/discussion.md.tmpl for spec / design questions or troubleshooting.
Draft to /tmp/reddit-mcp-post.md. Frontmatter must include title:; optionally flair:.
Run bash .claude/skills/reddit-mcp-post/scripts/copy.sh /tmp/reddit-mcp-post.md — body markdown lands on the clipboard; title and flair print to stderr.
Tell the user to paste the title into Reddit's title field, select the flair from the dropdown, switch the editor to Markdown mode, and paste the body.

Post shape

Mode	Word target	Use for
Show & Tell	200–600 words	"I built an MCP server / client for X"
Discussion / Help	100–400 words	Spec questions, transport debugging, design opinions

Always include: which MCP client(s) you tested with, which transport, which spec version (2024-11-05 / 2025-03-26 / 2025-06-18). r/mcp readers ask these in the comments anyway — pre-empt them.

Frontmatter format

---
title: "Show & Tell: file-search-on — content-type-aware file search as an MCP server"
flair: Show & Tell
---

title: is required. Keep under 300 chars (Reddit's hard cap); under ~120 chars reads better in the feed.
flair: is optional. Common r/mcp flairs include Show & Tell / Showcase, Discussion, Question / Help, Tutorial, News, Server, Client.
Quote the title (handles colons cleanly).

Voice and structure

See references/style.md for r/mcp culture, title conventions, what context the audience expects (clients tested, transport, spec version), and the security caveats specific to a community where readers will literally npx/uvx/pip install your code into their agent's blast radius.

Scripts

Run bash scripts/copy.sh <path-to-markdown> — strips YAML frontmatter, places body on the macOS clipboard, prints title (and flair) to stderr. Exits non-zero if the input file doesn't exist.

Templates

templates/show-and-tell.md.tmpl — "I built X" skeleton with hook, what-it-does, MCP-specific context (client / transport / spec version), interesting bits, what's next.
templates/discussion.md.tmpl — question / discussion skeleton for spec, transport, or design topics.

References

references/style.md — r/mcp voice, title patterns, flair list, the "client + transport + spec version" disclosure norm, security expectations, and what the markdown editor renders.

Conventions

Markdown source first, clipboard second. Always keep the .md file the user can re-edit.
Drafts go in /tmp/ — they're throwaway. If the user wants the source long-term, they say so and the agent writes to a path they specify.
Plain text clipboard. Reddit's markdown editor ingests plain markdown — pbcopy straight, no pandoc, no textutil.
macOS only. Linux / Windows would need a different clipboard hand-off — out of scope for v1.
Don't auto-publish. This skill produces clipboard content; the user submits manually via the Reddit web UI.
Disclose tested clients and transport. r/mcp readers expect this context — bake it into every Show & Tell.
r/mcp-specific. Etiquette and conventions vary between subreddits; this skill is scoped to r/mcp. The sibling reddit-golang-post skill follows the same structural pattern.

More from this repository

same repository

file-search-on-mcp

richardwooding/file-search-on

Uses the file-search-on MCP server (43 tools — search / search_semantic / validate_expr / stats / churn_owners / coupling / circular / unused_exports / references / find_duplicates / find_near_duplicates / find_duplicate_functions / diff_trees / api_diff / find_matches / imported_by / find_definition / code_graph / who_calls / calls / impact / call_path / trace / dead_code / test_gaps / coverage_gaps / complexity / review / list_archive_contents / read_file_in_archive / watch_search / detect_project / find_projects / resolve_project_for_path / read_attributes / read_lines / list_attributes / list_presets / query_preset / list_embedding_models / pull_embedding_model / index_stats / monitor_info) to query files by typed content-type attributes via CEL expressions — PDF page_count, image EXIF (camera/lens/GPS/taken_at), audio tags + bitrate, video codec/duration, archive entry_count, binary architecture, source LOC + functions + imports, notebook cells, markdown frontmatter, git-aware (last commit time / author

2026-07-035

cut-release

richardwooding/file-search-on

Cuts a tag-driven release of file-search-on (GoReleaser v2 + ko + Homebrew tap), watches the GitHub Actions Release workflow, and verifies the three publish targets — GitHub Release archives, ghcr.io OCI image, and the Homebrew tap commit at richardwooding/homebrew-tap — then surfaces the rollback procedure when something goes wrong. Use when the user asks to cut, tag, ship, publish, release, or roll back a version of file-search-on, including phrases like "release v0.3.0" or "the cask is broken, undo the release".

2026-06-265

open-source-prep

richardwooding/file-search-on

Audits a repository for open-source readiness — checks for LICENSE, README, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, CHANGELOG, `.github/` issue and PR templates, dependabot config, CI workflow, repo metadata (description / homepage / topics via `gh repo view`), and likely-leaked secrets in git history — then emits a prioritised punch-list. Pairs with templates for each community file (Contributor Covenant 2.1 boilerplate, MIT/Apache LICENSE pickers, README skeleton, CONTRIBUTING, SECURITY) and a license-choice decision guide. Use when preparing a repo for its first public release, taking a private repo public, reviewing a fork before contributing back, or hardening an already-open-source project.

2026-06-065

reddit-golang-post

richardwooding/file-search-on

Drafts a self-post for the [r/golang](https://www.reddit.com/r/golang) subreddit in Markdown with a YAML frontmatter title and optional flair, then runs a script that strips the frontmatter, places the body markdown on the macOS clipboard via `pbcopy`, and prints the title and flair to stderr so the user can paste them into Reddit's title field, flair dropdown, and markdown editor. Use when the user asks to write, draft, polish, or post content explicitly intended for r/golang — phrases like "post on r/golang", "Show & Tell on r/golang", "draft a golang subreddit post", or "write a Reddit post for golang".

2026-06-065

add-content-type

richardwooding/file-search-on

Registers a new file-format content type in file-search-on by creating a file under `internal/content/` that implements the four-method `ContentType` interface (`Name`, `Extensions`, `MagicBytes`, `Attributes(ctx, fsys, path)`), self-registers via `init()` calling `content.Register(...)`, and for image variants relies on the `image/` prefix block in `setTypeFlags` (`internal/celexpr/typeflags.go`) — covers CSV, YAML, plain-text, EPUB, new audio/image families, and similar formats. Use when adding support for a new file format so the search recognises it and reports a `content_type`; does NOT cover CEL attribute wiring for type-specific attributes, which is the `extend-cel-schema` skill's job.

2026-06-045

extend-cel-schema

richardwooding/file-search-on

Extends file-search-on's CEL attribute schema by editing the call sites that must move together — `cel.Variable(...)` declarations in `celexpr.New` (env.go), the `ResolveName` switch + `zeroDefaults` map in `activation.go`, and `celexpr.Schema()` — then runs an audit script that catches drift between them. Use when adding a new content-type attribute, promoting a new front-matter key like `summary` or `slug`, or extending an existing content type's attribute set; cel-go errors at runtime (not compile time) when these fall out of sync, so the audit script is the only deterministic guard.

2026-05-275

name

reddit-mcp-post

description

r/mcp Post

Quick start

Gather from the user: project / topic, key technical points, repo URL, which MCP clients have been tested (Claude Desktop, Cline, Continue, Cursor, Zed, etc.), transport (stdio / Streamable HTTP / SSE), and post type (Show & Tell vs Discussion / Help).
Pick a template — templates/show-and-tell.md.tmpl for project announcements, templates/discussion.md.tmpl for spec / design questions or troubleshooting.
Draft to /tmp/reddit-mcp-post.md. Frontmatter must include title:; optionally flair:.
Run bash .claude/skills/reddit-mcp-post/scripts/copy.sh /tmp/reddit-mcp-post.md — body markdown lands on the clipboard; title and flair print to stderr.
Tell the user to paste the title into Reddit's title field, select the flair from the dropdown, switch the editor to Markdown mode, and paste the body.

Post shape

Mode	Word target	Use for
Show & Tell	200–600 words	"I built an MCP server / client for X"
Discussion / Help	100–400 words	Spec questions, transport debugging, design opinions

Always include: which MCP client(s) you tested with, which transport, which spec version (2024-11-05 / 2025-03-26 / 2025-06-18). r/mcp readers ask these in the comments anyway — pre-empt them.

Frontmatter format

---
title: "Show & Tell: file-search-on — content-type-aware file search as an MCP server"
flair: Show & Tell
---

title: is required. Keep under 300 chars (Reddit's hard cap); under ~120 chars reads better in the feed.
flair: is optional. Common r/mcp flairs include Show & Tell / Showcase, Discussion, Question / Help, Tutorial, News, Server, Client.
Quote the title (handles colons cleanly).

Voice and structure

Scripts

Run bash scripts/copy.sh <path-to-markdown> — strips YAML frontmatter, places body on the macOS clipboard, prints title (and flair) to stderr. Exits non-zero if the input file doesn't exist.

Templates

templates/show-and-tell.md.tmpl — "I built X" skeleton with hook, what-it-does, MCP-specific context (client / transport / spec version), interesting bits, what's next.
templates/discussion.md.tmpl — question / discussion skeleton for spec, transport, or design topics.

References

references/style.md — r/mcp voice, title patterns, flair list, the "client + transport + spec version" disclosure norm, security expectations, and what the markdown editor renders.

Conventions

Markdown source first, clipboard second. Always keep the .md file the user can re-edit.
Drafts go in /tmp/ — they're throwaway. If the user wants the source long-term, they say so and the agent writes to a path they specify.
Plain text clipboard. Reddit's markdown editor ingests plain markdown — pbcopy straight, no pandoc, no textutil.
macOS only. Linux / Windows would need a different clipboard hand-off — out of scope for v1.
Don't auto-publish. This skill produces clipboard content; the user submits manually via the Reddit web UI.
Disclose tested clients and transport. r/mcp readers expect this context — bake it into every Show & Tell.
r/mcp-specific. Etiquette and conventions vary between subreddits; this skill is scoped to r/mcp. The sibling reddit-golang-post skill follows the same structural pattern.