跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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 的全部技能

报告此技能的问题