agentleFS
alxyrginalxyrgin/secondbrain_ai/.claude/skills/writing/SKILL.md

writing

Skill17 starsChanged 9 months agoMITView on GitHub

Создание контента для личного бренда — статьи, посты, туториалы. Use when user asks to "напиши статью", "создай пост", "подготовь контент", "write article", "create content", or when task requires content creation for blogging, LinkedIn, Medium, or other publishing platforms.

Files
SKILL.md

Writing Skill — создание контента

Методология создания качественного контента для личного бренда — от идеи до публикации.

Когда использовать

  • Нужно написать статью для Medium/Habr/LinkedIn
  • Подготовить пост в соцсети
  • Создать туториал или гайд
  • Написать кейс или case study
  • Переработать заметки в публикацию

Методология Writing

Фаза 1: Генерация идеи (5 мин)

Цель: Определить о чём писать

Источники идей:

Из опыта:

  • Что недавно изучил? (из /learning)
  • Какую проблему решил? (из проектов)
  • Какой инсайт получил? (из /research или /digest)

Из аудитории:

  • Какие вопросы задают клиенты?
  • Что обсуждается в комьюнити?
  • Что trending в нише?

Из целей:

  • Что хочу донести до аудитории?
  • Какую экспертизу показать?
  • Какую проблему помочь решить?

Тест идеи:

  • ✅ Это интересно мне?
  • ✅ Это полезно аудитории?
  • ✅ Я компетентен в этом?
  • ✅ Это не банально? (новый угол/опыт)

Фаза 2: Подготовка и research (10-15 мин)

Цель: Собрать материал для статьи

Что собирать:

Собственный опыт:

  • Поискать в Notes/ по теме
  • Проверить /recall — может обсуждал с кем-то
  • Вспомнить конкретные кейсы

Внешние источники:

  • /research если тема требует фактов
  • WebSearch для статистики и примеров
  • Похожие статьи (чтобы сделать лучше)

Структура материала:

## Research для статьи: [Тема]

**Главный месседж:**
[Что хочу донести в одном предложении]

**Целевая аудитория:**
[Для кого пишу]

**Структура:**
1. [Пункт 1]
2. [Пункт 2]
3. [Пункт 3]

**Материалы:**
- [Факт/статистика]
- [Личный опыт/кейс]
- [Пример/цитата]

Фаза 3: Создание структуры (5 мин)

Цель: Outline статьи

Проверенные структуры:

1. Problem → Solution (классика)

1. Введение (hook)
   - Релевантная проблема
   - Почему это важно

2. Проблема (pain)
   - Почему это сложно
   - Что идёт не так
   - Личный опыт столкновения

3. Решение (solution)
   - Как решил
   - Step-by-step
   - Примеры

4. Результаты (results)
   - Что получилось
   - Метрики/примеры

5. Выводы (takeaways)
   - Ключевые инсайты
   - Что делать дальше

2. Tutorial / How-To

1. Что будем делать
   - Конечный результат
   - Что понадобится

2. Шаг 1
   - Описание
   - Код/скриншоты
   - Объяснение

3. Шаг 2-N
   ...

4. Итоговый результат
   - Что получилось
   - Куда идти дальше

3. Listicle (N способов/примеров)

1. Вступление
   - Контекст
   - Почему эти N важны

2. Способ/Пример 1
   - Описание
   - Когда использовать
   - Результат

3. Способ/Пример 2-N
   ...

4. Заключение
   - Какой выбрать
   - Следующие шаги

4. Case Study

1. Контекст
   - Клиент/проект
   - Задача

2. Проблема
   - Что было не так
   - Вызовы

3. Процесс
   - Как подошли
   - Что делали

4. Результаты
   - Метрики
   - Outcome

5. Learnings
   - Что узнали
   - Что сделали бы иначе

Фаза 4: Написание черновика (30-60 мин)

Цель: Написать первую версию

Принципы написания:

Hook (первые 2-3 предложения):

  • Зацепить внимание
  • Показать проблему/вопрос
  • Пообещать решение

Основная часть:

  • Простым языком (пишешь другу)
  • Конкретные примеры (не абстракции)
  • Визуал где нужно (код, скриншоты, диаграммы)
  • Короткие параграфы (2-4 предложения)

Заключение:

  • Резюме ключевых идей
  • Call to action (что делать дальше)
  • Открытый вопрос для комментариев

Tone of Voice:

  • Для LinkedIn: профессионально, но дружелюбно
  • Для Medium: storytelling, личный опыт
  • Для Habr: технически, с деталями
  • Для Twitter: кратко, ёмко, с эмодзи

Фаза 5: Редактирование (15-20 мин)

Цель: Улучшить черновик

Checklist редактуры:

Структура:

  • Есть чёткая структура (intro → body → conclusion)
  • Логичный flow (одна мысль следует из другой)
  • Каждый параграф = одна идея

Контент:

  • Убрал воду и банальности
  • Добавил конкретные примеры
  • Факты подтверждены (ссылки на источники)
  • Визуал на месте (код, скриншоты)

Язык:

  • Простые слова (не overcomplicated)
  • Активный залог (не пассивный)
  • Убрал "я думаю", "возможно", "наверное"
  • Короткие предложения

Форматирование:

  • Заголовки структурируют текст
  • Списки вместо длинных перечислений
  • Выделение ключевых идей (bold)
  • Код в code blocks с подсветкой

Engagement:

  • Hook цепляет
  • Есть вопросы к читателю
  • CTA в конце понятен

Фаза 6: Подготовка к публикации (10 мин)

Цель: Финальные штрихи

Заголовок:

  • Цепляющий и понятный
  • Содержит ключевое слово
  • Обещает value

Примеры:

  • ❌ "Мысли о React"
  • ✅ "Как я уменьшил bundle size на 40% с помощью React 19"

Описание/Subtitle:

  • 1-2 предложения
  • Расширяет заголовок
  • TL;DR статьи

Обложка:

  • Релевантная изображение
  • Не stock photo (если возможно)
  • Можно AI-generated (MidJourney, DALL-E)

Теги:

  • 3-5 релевантных тегов
  • Смесь популярных + нишевых

SEO (если Medium/блог):

  • Ключевые слова в заголовке
  • Подзаголовки описательные
  • Alt text для картинок

Структура Writing Note

---
title: "[Платформа] — [Название статьи]"
platform: [LinkedIn / Medium / Habr / Blog]
status: [draft / review / published]
date: [YYYY-MM-DD]
tags: [writing, тема]
---

# [Название статьи]

**Платформа:** [LinkedIn / Medium]
**Статус:** Draft
**Целевая аудитория:** [Кто будет читать]

---

## Идея

[Главный месседж в одном предложении]

---

## Outline

1. [Раздел 1]
2. [Раздел 2]
3. [Раздел 3]

---

## Черновик

[Текст статьи]

---

## Редактура

**Что улучшить:**
- [ ] [Пункт 1]
- [ ] [Пункт 2]

---

## Метаданные для публикации

**Заголовок:**
[Финальный заголовок]

**Описание:**
[Subtitle/описание]

**Теги:**
[тег1, тег2, тег3]

**Обложка:**
[Ссылка на изображение или описание]

---

## После публикации

**Ссылка:** [URL]
**Дата публикации:** [YYYY-MM-DD]

**Метрики (через неделю):**
- Views:
- Likes:
- Comments:
- Shares:

**Feedback:**
[Что писали в комментариях]

Типы контента

Статья (1500-3000 слов)

Где: Medium, Habr, личный блог Focus: Глубина, примеры, storytelling Время: 2-4 часа


LinkedIn пост (300-500 слов)

Где: LinkedIn feed Focus: Инсайт + опыт + вопрос Время: 30-60 мин


Twitter thread

Где: X (Twitter) Focus: Одна идея в серии твитов Время: 20-30 мин


Tutorial / Guide (2000-5000 слов)

Где: Medium, Habr, Dev.to Focus: Step-by-step, код, результат Время: 4-6 часов


Content Calendar

Частота публикаций:

ПлатформаЧастотаТип
LinkedIn2-3 раза в неделюПосты + статьи
Medium1-2 раза в месяцЛонгриды
Twitter3-5 раз в неделюКороткие мысли
Habr1 раз в месяцТехнические статьи

Банк идей: Держать в Notes/Content/ideas.md список тем для статей


Интеграция с SecondBrain

Откуда брать материал:

  • /research → превратить в статью
  • /digest → insights для поста
  • /learning → туториал о том что изучил
  • Projects/ → case study проекта

Где хранить:

  • Черновики: Notes/Content/drafts/
  • Опубликованное: Notes/Content/published/

Связь с Todoist:

  • Создай recurring задачу "Написать статью" (например раз в неделю)
  • Или проект "Content Calendar" с задачами на месяц

Best Practices

DO ✅

  1. Write regularly — консистентность важнее качества
  2. Publish imperfect — done > perfect
  3. Share personal experience — люди читают за story
  4. Add value — каждая статья должна чему-то учить
  5. Engage in comments — отвечай на комментарии

DON'T ❌

  1. Не пиши ради публикации — только если есть что сказать
  2. Не копируй других — свой опыт + свой голос
  3. Не делай clickbait — заголовок = содержанию
  4. Не пиши слишком умно — простота = clarity
  5. Не забывай про CTA — что делать дальше?

Checklist Writing

  • Идея сформулирована и протестирована
  • Собран материал (research + personal experience)
  • Создан outline
  • Написан черновик
  • Отредактирован (structure + content + language)
  • Добавлен визуал (код/скриншоты/диаграммы)
  • Подготовлены метаданные (заголовок, теги, обложка)
  • Проверен на читаемость
  • Сохранён черновик в Notes/Content/
  • Запланирована публикация

Примеры запросов

Из опыта:

Хочу написать статью про то как настроил CI/CD

Из research:

Провёл research AI в продажах, давай превратим в статью для LinkedIn

Tutorial:

Напиши туториал как интегрировать Supabase с Next.js

Case study:

Сделай case study проекта ClientProject1

Download now (ZIP)

  • Other versions41 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 41

    1. wu-yc/LabClaw★ 1.1ksame name
    2. agentic-community/mcp-gateway-registry★ 1ksame name
    3. solana-foundation/explorer★ 836same name
    4. notque/vexjoy-agent★ 443same name
    5. notque/claude-code-toolkit★ 442same name
    6. zeuikli/claude-code-workspace★ 155same name
    7. joshuadavidthomas/agent-skills★ 49same name
    8. iliaal/ai-skills★ 45same name
    9. echris6/ai-business-skills★ 16same name
    10. aws-samples/sample-agentic-coding-harness-benchmarks★ 15same name

    31 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use addskill, astra-fullreview and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • ryanportfolioSkill

      addskill

      Create, import, update, or install repository or personal skills; includes runtime ownership, resources, and discovery validation.

      Also in 5 projects that use this

    • ryanportfolioSkill

      astra-fullreview

      Full multi-agent Codex review on gpt-6-astra at medium reasoning. Same verified lifecycle as codex-fullreview. Use for /astra-fullreview or 'full Astra review with sub-reviewers'.

      Also in 5 projects that use this

    • yogsoth-aiSkill

      dare

      DARE v4 is the product-level orchestrator for a research run. It turns a user request into a controlled sequence of North Star crystallization, executable specification, and phase-by-phase execution.

      Also in 5 projects that use this

    • howellsSkill

      astra-review

      Get an independent review from GPT-6 Astra via Codex, then verify its claims before acting. Use when the code can settle the question - does a diff hold, what changed when - or the user asks for Astra or a Codex review. Not for judgement calls (`fable-review`), criteria checks (`glm-review`) or codebase grades (`simplify`).

      Also in 5 projects that use this

    • +8 more from ryanportfolio
  • In this repository18 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.