Skip to content

Commit 57138c4

Browse files
jaworekjaworek
committed
init
0 parents  commit 57138c4

53 files changed

Lines changed: 3486 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/skills/stop-slop/SKILL.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
name: stop-slop
3+
description: Remove AI writing patterns from prose. Use when drafting, editing, or reviewing text to eliminate predictable AI tells.
4+
trigger: Writing prose, editing drafts, reviewing content for AI patterns
5+
author: Hardik Pandya (https://hvpandya.com)
6+
---
7+
8+
# Stop Slop
9+
10+
Eliminate predictable AI writing patterns from prose.
11+
12+
## Core Rules
13+
14+
1. **Cut filler phrases.** Remove throat-clearing openers and emphasis crutches. See [references/phrases.md](references/phrases.md).
15+
16+
2. **Break formulaic structures.** Avoid binary contrasts, dramatic fragmentation, rhetorical setups. See [references/structures.md](references/structures.md).
17+
18+
3. **Vary rhythm.** Mix sentence lengths. Two items beat three. End paragraphs differently.
19+
20+
4. **Trust readers.** State facts directly. Skip softening, justification, hand-holding.
21+
22+
5. **Cut quotables.** If it sounds like a pull-quote, rewrite it.
23+
24+
## Quick Checks
25+
26+
Before delivering prose:
27+
28+
- Three consecutive sentences match length? Break one.
29+
- Paragraph ends with punchy one-liner? Vary it.
30+
- Em-dash before a reveal? Remove it.
31+
- Explaining a metaphor? Trust it to land.
32+
33+
## Scoring
34+
35+
Rate 1-10 on each dimension:
36+
37+
| Dimension | Question |
38+
|-----------|----------|
39+
| Directness | Statements or announcements? |
40+
| Rhythm | Varied or metronomic? |
41+
| Trust | Respects reader intelligence? |
42+
| Authenticity | Sounds human? |
43+
| Density | Anything cuttable? |
44+
45+
Below 35/50: revise.
46+
47+
## Examples
48+
49+
See [references/examples.md](references/examples.md) for before/after transformations.
50+
51+
## License
52+
53+
MIT

‎.claude/skills/stop-slop/references/examples.md‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# Before/After Examples
2+
3+
## Example 1: Throat-Clearing + Binary Contrast
4+
5+
**Before:**
6+
> "Here's the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in."
7+
8+
**After:**
9+
> "Building products is hard. Technology is manageable. People aren't."
10+
11+
**Changes:** Removed opener, binary contrast structure, and emphasis crutch. Direct statements.
12+
13+
---
14+
15+
## Example 2: Filler + Unnecessary Reassurance
16+
17+
**Before:**
18+
> "It turns out that most teams struggle with alignment. The uncomfortable truth is that nobody wants to admit they're confused. And that's okay."
19+
20+
**After:**
21+
> "Teams struggle with alignment. Nobody admits confusion."
22+
23+
**Changes:** Cut hedging ("most"), removed throat-clearing phrases, deleted permission-granting ending.
24+
25+
---
26+
27+
## Example 3: Business Jargon Stack
28+
29+
**Before:**
30+
> "In today's fast-paced landscape, we need to lean into discomfort and navigate uncertainty with clarity. This matters because your competition isn't waiting."
31+
32+
**After:**
33+
> "Move faster. Your competition is."
34+
35+
**Changes:** Eliminated jargon entirely. Core message in six words.
36+
37+
---
38+
39+
## Example 4: Dramatic Fragmentation
40+
41+
**Before:**
42+
> "Speed. Quality. Cost. You can only pick two. That's it. That's the tradeoff."
43+
44+
**After:**
45+
> "Speed, quality, cost—pick two."
46+
47+
**Changes:** Single sentence. No performative emphasis.
48+
49+
---
50+
51+
## Example 5: Rhetorical Setup
52+
53+
**Before:**
54+
> "What if I told you that the best teams don't optimize for productivity? Here's what I mean: they optimize for learning. Think about it."
55+
56+
**After:**
57+
> "The best teams optimize for learning, not productivity."
58+
59+
**Changes:** Direct claim. No rhetorical scaffolding.

‎.claude/skills/stop-slop/references/phrases.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Phrases to Remove
2+
3+
## Throat-Clearing Openers
4+
5+
Remove these announcement phrases. State the content directly.
6+
7+
- "Here's the thing:"
8+
- "The uncomfortable truth is"
9+
- "It turns out"
10+
- "The real [X] is"
11+
- "Let me be clear"
12+
- "The truth is,"
13+
- "I'll say it again:"
14+
- "I'm going to be honest"
15+
- "Can we talk about"
16+
17+
## Emphasis Crutches
18+
19+
These add no meaning. Delete them.
20+
21+
- "Full stop." / "Period."
22+
- "Let that sink in."
23+
- "This matters because"
24+
- "Make no mistake"
25+
- "Here's why that matters"
26+
27+
## Business Jargon
28+
29+
Replace with plain language.
30+
31+
| Avoid | Use instead |
32+
|-------|-------------|
33+
| Navigate (challenges) | Handle, address |
34+
| Unpack (analysis) | Explain, examine |
35+
| Lean into | Accept, embrace |
36+
| Landscape (context) | Situation, field |
37+
| Game-changer | Significant, important |
38+
| Double down | Commit, increase |
39+
| Deep dive | Analysis, examination |
40+
| Take a step back | Reconsider |
41+
| Moving forward | Next, from now |
42+
| Circle back | Return to, revisit |
43+
| On the same page | Aligned, agreed |
44+
45+
## Filler Adverbs
46+
47+
Cut or replace:
48+
49+
- "At its core"
50+
- "In today's [X]"
51+
- "It's worth noting"
52+
- "Interestingly,"
53+
- "Importantly,"
54+
- "Crucially,"
55+
- "At the end of the day"
56+
- "When it comes to"
57+
- "In a world where"
58+
- "The reality is"
59+
60+
## Meta-Commentary
61+
62+
Remove self-referential asides:
63+
64+
- "Hint:"
65+
- "Plot twist:" / "Spoiler:"
66+
- "You already know this, but"
67+
- "But that's another post"
68+
- "X is a feature, not a bug"
69+
- "Dressed up as"

‎.claude/skills/stop-slop/references/structures.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Structures to Avoid
2+
3+
## Binary Contrasts
4+
5+
These create false drama. State the point directly.
6+
7+
| Pattern | Problem |
8+
|---------|---------|
9+
| "Not because X. Because Y." | Telegraphed reversal |
10+
| "[X] isn't the problem. [Y] is." | Formulaic reframe |
11+
| "The answer isn't X. It's Y." | Predictable pivot |
12+
| "It feels like X. It's actually Y." | Setup/reveal cliche |
13+
| "The question isn't X. It's Y." | Rhetorical misdirection |
14+
15+
**Instead:** State Y directly. "The problem is Y." "Y matters here."
16+
17+
## Dramatic Fragmentation
18+
19+
Sentence fragments for emphasis read as manufactured profundity.
20+
21+
| Pattern | Problem |
22+
|---------|---------|
23+
| "[Noun]. That's it. That's the [thing]." | Performative simplicity |
24+
| "X. And Y. And Z." | Staccato drama |
25+
| "This unlocks something. [Word]." | Artificial revelation |
26+
27+
**Instead:** Complete sentences. Trust content over presentation.
28+
29+
## Rhetorical Setups
30+
31+
These announce insight rather than deliver it.
32+
33+
| Pattern | Problem |
34+
|---------|---------|
35+
| "What if [reframe]?" | Socratic posturing |
36+
| "Here's what I mean:" | Redundant preview |
37+
| "Think about it:" | Condescending prompt |
38+
| "And that's okay." | Unnecessary permission |
39+
40+
**Instead:** Make the point. Let readers draw conclusions.
41+
42+
## Formulaic Constructions
43+
44+
| Pattern | Problem |
45+
|---------|---------|
46+
| "By the time X, I was Y." | Narrative template |
47+
| "X that isn't Y" | Indirect. Say "X is broken" |
48+
49+
## Rhythm Patterns
50+
51+
| Pattern | Fix |
52+
|---------|-----|
53+
| Three-item lists | Use two items or one |
54+
| Questions answered immediately | Let questions breathe or cut them |
55+
| Paragraphs starting with "So" | Start with content |
56+
| Sentences starting with "Look," | Remove |
57+
| Every paragraph ends punchily | Vary endings |
58+
| Em-dashes before reveals | Use periods or commas |

‎.github/workflows/docs.yml‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
name: Docs
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
8+
concurrency:
9+
group: ${{ github.workflow }}-${{ github.ref }}
10+
cancel-in-progress: true
11+
12+
jobs:
13+
build-docs:
14+
name: Build docs
15+
runs-on: ubuntu-latest
16+
steps:
17+
- name: Checkout
18+
uses: actions/checkout@v4
19+
20+
- name: Setup Bun
21+
uses: oven-sh/setup-bun@v2
22+
23+
- name: Install dependencies
24+
run: bun install --frozen-lockfile
25+
26+
- name: Build docs
27+
run: bun run build
28+
29+
- name: Upload docs artifact
30+
uses: actions/upload-pages-artifact@v3
31+
with:
32+
path: build
33+
34+
deploy-docs:
35+
name: Deploy docs
36+
needs: build-docs
37+
runs-on: ubuntu-latest
38+
if: github.ref == 'refs/heads/main'
39+
permissions:
40+
contents: read
41+
pages: write
42+
id-token: write
43+
environment:
44+
name: github-pages
45+
url: ${{ steps.deployment.outputs.page_url }}
46+
steps:
47+
- name: Deploy to GitHub Pages
48+
id: deployment
49+
uses: actions/deploy-pages@v4

‎.gitignore‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Local
2+
.DS_Store
3+
*.local
4+
*.log*
5+
6+
# Dist
7+
node_modules
8+
dist/
9+
doc_build/
10+
build
11+
12+
# IDE
13+
.vscode/*
14+
!.vscode/extensions.json
15+
.idea

‎CLAUDE.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# CLAUDE.md
2+
3+
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4+
5+
## Project Overview
6+
7+
Documentation site for React Native Meta Horizon OS - a framework for building Meta Quest VR apps with React Native. Built with Rspress (static site generator) using Callstack's theme preset.
8+
9+
## Commands
10+
11+
- `npm run dev` - Start development server with hot reload
12+
- `npm run build` - Build production site to `build/` directory
13+
- `npm run preview` - Preview production build locally
14+
- `npm run check` - Run Biome linter and formatter with auto-fix
15+
- `npm run format` - Run Biome formatter only
16+
17+
## Architecture
18+
19+
### Documentation Structure
20+
21+
All documentation lives in `src/` with this hierarchy:
22+
- `src/index.md` - Landing page
23+
- `src/docs/` - Main documentation sections
24+
- `src/_nav.json` - Top-level navigation
25+
- `src/docs/_meta.json` - Sidebar structure for docs section
26+
27+
Each directory can have a `_meta.json` file controlling sidebar ordering and labels. Files named `index.md` serve as section landing pages.
28+
29+
### Configuration
30+
31+
- `rspress.config.ts` - Main site config using `@callstack/rspress-preset` wrapper
32+
- `biome.json` - Linter/formatter config (space indentation, single quotes for JS)
33+
34+
### Content Guidelines
35+
36+
Documentation covers:
37+
- Getting Started: Prerequisites, creating first app, platform guidelines
38+
- Guides: Library compatibility, UI/UX patterns, releasing apps
39+
- Reference: Showcase app examples

0 commit comments

Comments
 (0)