本文へ移動
cccskills
無料GitHub で公開

docs-update

Update the product docs at docs.bagofwords.com (Mintlify) with text and fresh screenshots after a user-facing change ships. Use when a merged change alters user-visible behavior, adds a feature, or when asked to update/refresh documentation.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwordsスター 463(GitHub 463 + cccskills 0)

実行スコア 未検証

インストール方法を見る

含まれるファイル(1)

  • SKILL.md2.9 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Docs Update — Mintlify + fresh screenshots

The product docs live on Mintlify (docs.bagofwords.com), managed through the Mintlify MCP server — not in this repo. docs/ here contains internal design docs only.

When to run

After a user-facing change merges: new feature, changed flow, renamed UI, changed configuration. Skip for internal refactors.

Flow

  1. Find what's affected. With the Mintlify MCP: checkout the deployment (this opens an isolated editing session/branch — surface the returned editorUrl to the user), then search / read / list_nodes for pages mentioning the touched feature. List affected pages before editing.
  2. Capture fresh screenshots of the new behavior from a seeded local stack (see the ui-evidence skill for the full capture procedure):
    tools/agent/boot_stack.sh && cd backend && uv run python ../tools/agent/seed_org.py --demo
    cd ../frontend && node ../tools/agent/capture.mjs http://localhost:3000/<page> shot.png
    
    Stage them under docs/screenshots/pending-changes/<page-slug>/ in this repo so they're reviewable alongside the docs PR. Match the style of existing docs images (clean seeded data, 1440px wide, no dev toolbars).
  3. Edit pages via the session tools:
    • body text → edit_page (string replace) or write_page (full rewrite)
    • frontmatter (title, description, icon) → update_node, never edit_page
    • new pages / navigation → create_node; site config → update_config
  4. Images: if the MCP session cannot upload binary images, reference the staged files and note in the docs PR description that the images in docs/screenshots/pending-changes/<page-slug>/ must be uploaded via the Mintlify editor (editorUrl) before merge. Do not publish pages pointing at broken image paths.
  5. Review the diff (diff / get_session_state), then save — this opens a docs PR. Never use Mintlify code-mode (execute_code) for content work: it writes straight to the live deployment with no PR safety net.
  6. Report back: affected pages, the docs PR link, and the editorUrl.

Writing rules

  • Describe what the user sees now — don't narrate the change ("previously…", "as of this release…") unless editing a changelog page.
  • Verify every claim against the running app you just booted, not against the code diff — docs describe behavior, and this catches half-shipped UI.
  • Screenshots must come from seeded sandbox data only — never real customer names, tokens, or connection strings.
  • Keep terminology consistent with the app's locale catalogs (locales/en.json) — the UI string is the source of truth for feature names.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

Add a new data source / connection type (e.g. a SQL Server-like database) end to end — client with get_schemas/execute_query, config + credentials schemas, registry entry, icon, tests — plus the verification steps. Also covers adding or updating an MCP connector (a preset, not a new type). Use when adding or significantly extending a connector.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

Add a new LLM model to the preset catalog, or a whole new LLM provider — with the mandatory pre-flight verification of model id, pricing, and context window against the provider's official docs. Use when asked to add/update LLM models, providers, or pricing.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

Query, visualize, and analyze data in a Bag of Words (BOW) workspace via the bagofwords MCP tools. Use for creating reports, running tracked queries, and building dashboards.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

The locale/i18n architecture of bagofwords — catalogs, resolution order, RTL, backend contracts — and the procedures for adding strings, adding a locale, or translating UI. Use when adding/changing user-facing strings, working on RTL, emails, localized errors, or anything locale-related.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

qa

無料

Run a live QA pass over the app — first map all user-facing functionality, then boot the full stack and manually exercise flows with Playwright, recording pass/fail evidence and filing a QA report. Use for release QA, post-merge smoke passes, or "QA the app / this area" requests.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets. Use when positioning has changed, README screenshots are stale, a launch/demo workspace is needed, or the user asks to populate agents, reports, dashboards, evals, automations, connectors, or monitoring for product storytelling.

日本語の概要は準備中です。原文の説明を表示しています。

bagofwords1/bagofwords4632026年10月26日 更新

bagofwords1 のスキルをすべて見る

このスキルの問題を報告する