# filesort

Sort and organize files by size from the command line.

## Features

- Sort files in any directory by size
- Filter by file extension
- Export results to CSV
- Human-readable size formatting

## Installation

```bash
pip install filesort

filesort .

1.2 GB    video.mp4
856 MB    dataset.zip
45 MB     photo.jpg
2.1 KB    README.md

filesort [OPTIONS] DIRECTORY

filesort . --reverse --number 10

filesort ~/Videos --extension mp4 --reverse

---

## Content Creator

### Overview

**Triggers:** Writing blog posts, creating social media content, developing marketing copy, crafting engaging headlines, content creation, blogging, social media, audience engagement

### When to Use

- Writing blog posts and articles
- Creating social media content (Twitter, LinkedIn, Instagram)
- Developing marketing copy
- Crafting compelling headlines and hooks
- Creating email newsletters
- Writing product descriptions

### Content Creation Framework

<Steps>
  <Step title="Know Your Audience">
    - Who are you writing for?
    - What are their pain points?
    - What level of expertise do they have?
    - What action do you want them to take?
  </Step>
  
  <Step title="Hook Immediately">
    - First sentence must grab attention
    - Lead with value, intrigue, or emotion
    - Make a promise you'll deliver on
  </Step>
  
  <Step title="Provide Value">
    - Actionable insights
    - Specific examples
    - Practical takeaways
    - Original perspectives
  </Step>
  
  <Step title="Make It Scannable">
    - Short paragraphs (2-3 sentences)
    - Subheadings every 3-4 paragraphs
    - Bulleted or numbered lists
    - Bold key points
  </Step>
  
  <Step title="End With Action">
    - Clear call-to-action
    - Next steps
    - Conversation starter
    - Resource links
  </Step>
</Steps>

### Platform-Specific Guidelines

<Tabs>
  <Tab title="Blog Posts">
    **Length:** 800-2000 words
    
    **Structure:**
    - Attention-grabbing headline
    - Opening hook (question, statistic, bold claim)
    - Problem description
    - Solution with examples
    - Key takeaways
    - Clear next steps
    
    **Style:**
    - Scannable with subheadings
    - Mix of text and lists
    - Include visuals where helpful
    - Personal stories work well
  </Tab>
  
  <Tab title="Twitter/X Threads">
    **Length:** 280 chars per tweet
    
    **Structure:**
    1. Hook - bold claim or question
    2. Context or problem setup
    3-5. Main points with examples
    6. Key takeaway
    7. CTA - retweet, follow, link
    
    **Style:**
    - Direct and punchy
    - One idea per tweet
    - Use line breaks for readability
    - Emojis sparingly for emphasis
  </Tab>
  
  <Tab title="LinkedIn Posts">
    **Length:** Up to 1300 characters
    
    **Structure:**
    - Personal story or observation
    - Transition to broader insight
    - 3-5 actionable points
    - Conclusion with engagement question
    - Relevant hashtags (3-5)
    
    **Style:**
    - Professional but personal
    - Numbered lists work well
    - Ask questions to drive engagement
    - Share lessons learned
  </Tab>
  
  <Tab title="Email Newsletters">
    **Subject:** Curiosity-driven, 50 chars max
    
    **Structure:**
    - Personal opening
    - Value proposition paragraph
    - Bulleted preview of content
    - Main content sections with headers
    - Clear CTA button or link
    - Warm sign-off
    
    **Style:**
    - Conversational tone
    - Short paragraphs
    - Mix text with visuals
    - Single primary CTA
  </Tab>
</Tabs>

### Headline Formulas

1. **How To**: "How to [Achieve Desired Result] in [Timeframe]"
2. **List**: "[Number] Ways to [Solve Problem]"
3. **Question**: "Are You Making These [Number] [Mistakes]?"
4. **Negative**: "Stop [Doing X] Until You Read This"
5. **Curiosity Gap**: "The [Adjective] Secret to [Desired Result]"
6. **Before/After**: "From [Bad State] to [Good State] in [Timeframe]"

### Engagement Techniques

<AccordionGroup>
  <Accordion title="Storytelling">
    - Start with a relatable scenario
    - Build tension or curiosity
    - Deliver insight or resolution
    - Connect to reader's situation
  </Accordion>
  
  <Accordion title="Social Proof">
    - Case studies and examples
    - Testimonials and quotes
    - Statistics and data
    - Expert opinions
  </Accordion>
  
  <Accordion title="Emotional Triggers">
    - **Fear**: "Don't make this costly mistake"
    - **Curiosity**: "The surprising truth about..."
    - **Aspiration**: "How top performers..."
    - **Urgency**: "Limited time opportunity"
    - **Belonging**: "Join thousands who..."
  </Accordion>
</AccordionGroup>

### Example: LinkedIn Post

---

## Editor

### Overview

**Triggers:** Editing text, proofreading documents, improving clarity, fixing grammar, refining style, "edit", "proofread", "improve", "revise", grammar, readability

### When to Use

- Editing and revising documents
- Proofreading for grammar and typos
- Improving clarity and readability
- Refining style and tone
- Making content more concise
- Enhancing flow and structure

### Editing Levels

<CardGroup cols={2}>
  <Card title="Proofreading" icon="spell-check">
    Surface errors: spelling, grammar, punctuation, capitalization, formatting
  </Card>
  <Card title="Copy Editing" icon="pen">
    Language and style: sentence structure, word choice, redundancy, consistency
  </Card>
  <Card title="Line Editing" icon="align-left">
    Flow and clarity: transitions, variety, tone, pacing, expression clarity
  </Card>
  <Card title="Developmental Editing" icon="sitemap">
    Structure and content: organization, argument strength, missing info, effectiveness
  </Card>
</CardGroup>

### Editing Checklist

<Tabs>
  <Tab title="Clarity">
    - [ ] Is the main point immediately clear?
    - [ ] Are complex ideas explained simply?
    - [ ] Could any sentence be misunderstood?
    - [ ] Are technical terms defined?
    - [ ] Is jargon necessary or just showing off?
  </Tab>
  
  <Tab title="Concision">
    - [ ] Can any words be cut without losing meaning?
    - [ ] Are there redundant phrases?
    - [ ] Could complex sentences be simplified?
    - [ ] Is every sentence necessary?
    - [ ] Are descriptions overly detailed?
  </Tab>
  
  <Tab title="Grammar & Mechanics">
    - [ ] Subject-verb agreement correct?
    - [ ] Pronoun references clear?
    - [ ] Consistent verb tense?
    - [ ] Proper punctuation?
    - [ ] No sentence fragments (unless intentional)?
  </Tab>
  
  <Tab title="Style & Tone">
    - [ ] Consistent voice throughout?
    - [ ] Appropriate formality level?
    - [ ] Active voice preferred over passive?
    - [ ] Varied sentence structure?
    - [ ] Strong verbs instead of weak + adverbs?
  </Tab>
</Tabs>

### Common Issues to Fix

<AccordionGroup>
  <Accordion title="Wordiness">
    | Wordy | Concise |
    |-------|--------|
    | Due to the fact that | Because |
    | In order to | To |
    | At this point in time | Now |
    | Has the ability to | Can |
    | Make a decision | Decide |
  </Accordion>
  
  <Accordion title="Passive Voice">
    **Before:** "The report was written by the team"
    **After:** "The team wrote the report"
    
    **Before:** "Mistakes were made"
    **After:** "We made mistakes"
  </Accordion>
  
  <Accordion title="Weak Verbs">
    | Weak | Strong |
    |------|-------|
    | Make a decision | Decide |
    | Give consideration to | Consider |
    | Came to the realization | Realized |
    | Provide assistance | Help |
  </Accordion>
  
  <Accordion title="Redundancy">
    | Redundant | Better |
    |-----------|-------|
    | Free gift | Gift |
    | Future plans | Plans |
    | Added bonus | Bonus |
    | Completely finished | Finished |
  </Accordion>
</AccordionGroup>

### Example: Before and After

**Original:**
"Our company specializes in providing solutions that have the ability to help businesses in order to achieve their goals. We make a commitment to delivering quality at this point in time."

**Edited:**
"We help businesses achieve their goals through quality solutions."

**Improvements:**
- Reduced from 30 words to 11 words
- Removed filler phrases ("in order to", "at this point in time")
- Changed weak phrases to strong verbs ("help" vs "have the ability to help")
- More direct and confident tone

---

## Email Drafter

### Overview

**Triggers:** Writing emails, composing messages, professional communication, email templates, business correspondence

### When to Use

- Writing professional emails
- Drafting difficult conversations
- Creating email templates
- Responding to various scenarios
- Adjusting tone and formality
- Following up on communications

### Email Components

**Subject Line:**
- Clear and specific
- Action-oriented when needed
- 50 characters or less
- Avoid spam trigger words

**Opening:**
- Appropriate greeting
- Context if needed
- Get to the point quickly

**Body:**
- One clear purpose per email
- Short paragraphs
- Bullets for multiple points
- Professional but warm

**Closing:**
- Clear next steps or call-to-action
- Appropriate sign-off
- Contact information

### Tone Guidelines

<CardGroup cols={3}>
  <Card title="Formal">
    Executive communication, external partners, serious matters
  </Card>
  <Card title="Professional">
    Colleagues, clients, standard business communication
  </Card>
  <Card title="Casual">
    Team members, friendly relationships, informal updates
  </Card>
</CardGroup>

---

## Installation

Add all writing skills:

```bash
npx skills add shubhamsaboo/awesome-agent-skills