# writing-streamlit-apps

Скилл writing-streamlit-apps для Claude Code помогает писать и отлаживать Python-код Streamlit-приложений, читающих данные PostHog в sandbox. Код используют для экранов с таблицами, метриками и графиками.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 177 установок · ★ 101 у репозитория
- Автор: PostHog
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/writing-streamlit-apps/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/writing-streamlit-apps

## Что делает

Скилл описывает код для Streamlit 1.31 в PostHog sandbox. Данные приложение получает через `posthog_apps.query()` в виде `pandas.DataFrame`; запросы пишутся на HogQL. В рекомендациях есть кэширование вызовов, хранение состояния в `st.session_state`, компоновка через `st.columns`, `st.tabs` и `st.expander`, а также графики Plotly и таблицы.

Точка входа — `app.py`. Рядом можно передать вспомогательные модули и файлы данных, но пути к ним нужно строить через `Path(__file__).parent`. В образе есть Python 3.11 и перечисленные библиотеки, включая `pandas`, `plotly`, `duckdb` и `scikit-learn`; добавить пакет через `pip` нельзя.

Свободный текст из виджета нельзя напрямую вставлять в HogQL: зритель сможет отправить запрос с правами автора приложения. Запросы также ограничены сервером по времени и памяти, поэтому большие выборки нужно агрегировать и ограничивать до передачи в `pandas`. Файлы в sandbox не переживают перезапуск.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill writing-streamlit-apps -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/writing-streamlit-apps/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/writing-streamlit-apps/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill writing-streamlit-apps -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/writing-streamlit-apps/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill writing-streamlit-apps -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/writing-streamlit-apps/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/writing-streamlit-apps
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/writing-streamlit-apps/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill writing-streamlit-apps -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/writing-streamlit-apps
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/writing-streamlit-apps/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill writing-streamlit-apps -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/writing-streamlit-apps/SKILL.md

## Когда брать
- написать Streamlit-приложение для данных PostHog
- собрать экран с метриками, таблицами и графиками
- закэшировать запросы между перезапусками Streamlit
- сохранить выбор пользователя в `st.session_state`
- обработать ошибку выполнения HogQL-запроса

## Примеры запросов агенту
- Напиши `app.py` для Streamlit, который показывает число событий по дням из PostHog через `posthog_apps.query()`.
- Добавь кэширование запросов и безопасный выбор периода через виджет, не вставляй свободный текст в HogQL.
- Отладь ошибку запроса в приложении и выведи сообщение через `st.error`.

## Похожие
- [harvard-artifacts-etl-streamlit](https://affpapa.org/nevibecode/skills/harvard-artifacts-etl-streamlit.md) — скилл · 1400 установок
- [streamlit-to-marimo](https://affpapa.org/nevibecode/skills/streamlit-to-marimo.md) — скилл · 2400 установок
- [harvard-artifacts-etl-streamlit-analytics](https://affpapa.org/nevibecode/skills/harvard-artifacts-etl-streamlit-analytics.md) — скилл · 1900 установок
- [debugging-streamlit](https://affpapa.org/nevibecode/skills/debugging-streamlit.md) — скилл · 502 установки
- [understanding-streamlit-architecture](https://affpapa.org/nevibecode/skills/understanding-streamlit-architecture.md) — скилл · 123 установки
- [streamlit](https://affpapa.org/nevibecode/rules/streamlit.md) — правило · ★ 3589 у репозитория

Из того же набора: [posthog/ai-plugin](https://affpapa.org/nevibecode/by/posthog/ai-plugin.md) — 82 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
