opencode-skills-collection 4.1.1 → 4.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of opencode-skills-collection might be problematic. Click here for more details.
- package/bundled-skills/.antigravity-install-manifest.json +133 -1
- package/bundled-skills/360-feedback-system/SKILL.md +481 -0
- package/bundled-skills/access-matrix/SKILL.md +338 -0
- package/bundled-skills/accounting-audit-system-builder/SKILL.md +302 -0
- package/bundled-skills/accounting-audit-system-builder/references/catalog.md +114 -0
- package/bundled-skills/accounting-software-selection/SKILL.md +427 -0
- package/bundled-skills/accounting-software-selection/references/build-artifacts.md +362 -0
- package/bundled-skills/accounting-software-selection/references/common-pitfalls.md +44 -0
- package/bundled-skills/accounting-software-selection/references/field-reference.md +93 -0
- package/bundled-skills/accounting-software-selection/references/select-options.md +202 -0
- package/bundled-skills/admin-access-register/SKILL.md +381 -0
- package/bundled-skills/advanced-analytics-dashboard/SKILL.md +318 -0
- package/bundled-skills/ai-image-generation-studio/SKILL.md +259 -0
- package/bundled-skills/ai-logo-maker/SKILL.md +259 -0
- package/bundled-skills/ai-multilingual-dubbing/SKILL.md +259 -0
- package/bundled-skills/ai-photo-restyler/SKILL.md +259 -0
- package/bundled-skills/ai-podcast-voiceover/SKILL.md +259 -0
- package/bundled-skills/alumni-re-hire-tracker/SKILL.md +314 -0
- package/bundled-skills/announcement-board/SKILL.md +336 -0
- package/bundled-skills/antigravity-maintainer-batch-release/SKILL.md +63 -4
- package/bundled-skills/asset-it-management/SKILL.md +407 -0
- package/bundled-skills/attendance/SKILL.md +331 -0
- package/bundled-skills/audit-log/SKILL.md +314 -0
- package/bundled-skills/audit-preparation/SKILL.md +416 -0
- package/bundled-skills/beatra/SKILL.md +260 -0
- package/bundled-skills/board-governance/SKILL.md +360 -0
- package/bundled-skills/brand-growth-system-builder/SKILL.md +360 -0
- package/bundled-skills/brand-kit-print-collateral/SKILL.md +498 -0
- package/bundled-skills/buddy-program-manager/SKILL.md +329 -0
- package/bundled-skills/budget-cash-flow/SKILL.md +352 -0
- package/bundled-skills/busabase/SKILL.md +118 -0
- package/bundled-skills/business-email-template/SKILL.md +480 -0
- package/bundled-skills/business-email-template/references/common-pitfalls.md +30 -0
- package/bundled-skills/business-website-setup/SKILL.md +489 -0
- package/bundled-skills/business-website-setup/references/common-pitfalls.md +32 -0
- package/bundled-skills/candidate-talent-pool/SKILL.md +359 -0
- package/bundled-skills/capacity-workload-planner/SKILL.md +354 -0
- package/bundled-skills/changelog-entry/SKILL.md +141 -0
- package/bundled-skills/clients-accounts/SKILL.md +398 -0
- package/bundled-skills/code-of-conduct/SKILL.md +488 -0
- package/bundled-skills/code-of-conduct/references/common-pitfalls.md +31 -0
- package/bundled-skills/company-email-accounts/SKILL.md +404 -0
- package/bundled-skills/competency-matrix/SKILL.md +335 -0
- package/bundled-skills/contract-document-renewal/SKILL.md +396 -0
- package/bundled-skills/course-upskilling-requests/SKILL.md +354 -0
- package/bundled-skills/credit-cycle-analysis/SKILL.md +303 -0
- package/bundled-skills/credit-cycle-analysis/references/best-practices.md +35 -0
- package/bundled-skills/credit-cycle-analysis/references/common-pitfalls.md +5 -0
- package/bundled-skills/credit-cycle-analysis/references/examples.md +34 -0
- package/bundled-skills/credit-cycle-analysis/references/field-reference.md +47 -0
- package/bundled-skills/credit-cycle-analysis/references/how-it-works.md +494 -0
- package/bundled-skills/credit-cycle-analysis/references/security-notes.md +16 -0
- package/bundled-skills/credit-cycle-analysis/references/select-options.md +32 -0
- package/bundled-skills/csv-manual-export/SKILL.md +499 -0
- package/bundled-skills/csv-manual-export/references/common-pitfalls.md +19 -0
- package/bundled-skills/culture-retention/SKILL.md +346 -0
- package/bundled-skills/data-export-engine/SKILL.md +308 -0
- package/bundled-skills/data-privacy-controls/SKILL.md +317 -0
- package/bundled-skills/day-book/SKILL.md +499 -0
- package/bundled-skills/day-book/references/best-practices.md +32 -0
- package/bundled-skills/day-book/references/common-pitfalls.md +58 -0
- package/bundled-skills/day-book/references/field-reference.md +45 -0
- package/bundled-skills/day-book/references/how-it-works.md +7 -0
- package/bundled-skills/day-book/references/related-skills.md +18 -0
- package/bundled-skills/day-book/references/relations.md +14 -0
- package/bundled-skills/day-book/references/reusable-prompt.md +50 -0
- package/bundled-skills/day-book/references/security-safety-notes.md +19 -0
- package/bundled-skills/day-book/references/select-options.md +38 -0
- package/bundled-skills/deep-research-framework/SKILL.md +81 -0
- package/bundled-skills/dei-dashboard/SKILL.md +307 -0
- package/bundled-skills/design-theme-guide/SKILL.md +472 -0
- package/bundled-skills/disciplinary-pip-tracker/SKILL.md +345 -0
- package/bundled-skills/document-management-system/SKILL.md +328 -0
- package/bundled-skills/ecommerce-listing-image-set/SKILL.md +259 -0
- package/bundled-skills/employee-suggestion-hub/SKILL.md +322 -0
- package/bundled-skills/esop-equity-tracker/SKILL.md +331 -0
- package/bundled-skills/events-activities/SKILL.md +355 -0
- package/bundled-skills/expense-accounting/SKILL.md +496 -0
- package/bundled-skills/expense-accounting/references/common-pitfalls.md +41 -0
- package/bundled-skills/expense-accounting/references/related-skills.md +11 -0
- package/bundled-skills/expense-accounting/references/reusable-prompt.md +36 -0
- package/bundled-skills/expense-management/SKILL.md +351 -0
- package/bundled-skills/five-axis-code-review/SKILL.md +78 -0
- package/bundled-skills/free-design-resources/SKILL.md +480 -0
- package/bundled-skills/free-design-resources/references/common-pitfalls.md +44 -0
- package/bundled-skills/free-design-resources/references/related-skills.md +24 -0
- package/bundled-skills/free-design-resources/references/reusable-prompt.md +12 -0
- package/bundled-skills/gamification-engine/SKILL.md +307 -0
- package/bundled-skills/gbp-local-seo-intent/SKILL.md +466 -0
- package/bundled-skills/gbp-local-seo-intent/references/best-practices.md +41 -0
- package/bundled-skills/gbp-local-seo-intent/references/common-pitfalls.md +40 -0
- package/bundled-skills/gbp-local-seo-intent/references/related-skills.md +17 -0
- package/bundled-skills/gbp-local-seo-intent/references/reusable-prompt.md +11 -0
- package/bundled-skills/gbp-local-seo-intent/references/security-safety-notes.md +27 -0
- package/bundled-skills/git-commit-message/SKILL.md +76 -0
- package/bundled-skills/health-wellness/SKILL.md +334 -0
- package/bundled-skills/idea-to-blueprint/LICENSE +21 -0
- package/bundled-skills/idea-to-blueprint/SKILL.md +260 -0
- package/bundled-skills/idea-to-blueprint/assets/AGENTS.md.template +38 -0
- package/bundled-skills/idea-to-blueprint/assets/CLAUDE.md.template +38 -0
- package/bundled-skills/idea-to-blueprint/assets/DECISIONS.md.template +14 -0
- package/bundled-skills/idea-to-blueprint/assets/PROGRESS.md.template +47 -0
- package/bundled-skills/idea-to-blueprint/assets/session-prompt.md +23 -0
- package/bundled-skills/idea-to-blueprint/references/architecture-decisions.md +202 -0
- package/bundled-skills/idea-to-blueprint/references/blueprint-template.md +259 -0
- package/bundled-skills/idea-to-blueprint/references/code-quality-and-review.md +216 -0
- package/bundled-skills/idea-to-blueprint/references/design-minimal.md +96 -0
- package/bundled-skills/idea-to-blueprint/references/edge-case-catalog.md +239 -0
- package/bundled-skills/idea-to-blueprint/references/intake-questions.md +105 -0
- package/bundled-skills/idea-to-blueprint/references/research-protocol.md +196 -0
- package/bundled-skills/idea-to-blueprint/references/session-protocol.md +133 -0
- package/bundled-skills/idea-to-blueprint/references/stories-ac-tests.md +194 -0
- package/bundled-skills/idea-to-blueprint/references/ux-writing-guide.md +128 -0
- package/bundled-skills/idea-to-blueprint/scripts/lint_blueprint.py +460 -0
- package/bundled-skills/intern-program/SKILL.md +354 -0
- package/bundled-skills/internal-communication/SKILL.md +318 -0
- package/bundled-skills/inventory-stock-reconciliation/SKILL.md +470 -0
- package/bundled-skills/inventory-stock-reconciliation/references/best-practices.md +18 -0
- package/bundled-skills/inventory-stock-reconciliation/references/common-pitfalls.md +42 -0
- package/bundled-skills/inventory-stock-reconciliation/references/related-skills.md +13 -0
- package/bundled-skills/inventory-stock-reconciliation/references/relations.md +8 -0
- package/bundled-skills/inventory-stock-reconciliation/references/reusable-prompt.md +31 -0
- package/bundled-skills/inventory-stock-reconciliation/references/security-safety-notes.md +17 -0
- package/bundled-skills/inventory-stock-reconciliation/references/select-options.md +45 -0
- package/bundled-skills/invoices-billing/SKILL.md +385 -0
- package/bundled-skills/issue-grievance-tracker/SKILL.md +400 -0
- package/bundled-skills/json-schema-manual/SKILL.md +309 -0
- package/bundled-skills/json-schema-manual/references/best-practices.md +9 -0
- package/bundled-skills/json-schema-manual/references/common-pitfalls.md +25 -0
- package/bundled-skills/json-schema-manual/references/input-modules.md +203 -0
- package/bundled-skills/json-schema-manual/references/related-skills.md +8 -0
- package/bundled-skills/json-schema-manual/references/reusable-prompt.md +10 -0
- package/bundled-skills/json-schema-manual/references/security-safety-notes.md +13 -0
- package/bundled-skills/knowledge-base/SKILL.md +318 -0
- package/bundled-skills/kpi-tracker/SKILL.md +345 -0
- package/bundled-skills/learning-career-development/SKILL.md +349 -0
- package/bundled-skills/leave-management/SKILL.md +341 -0
- package/bundled-skills/legal-compliance-vault/SKILL.md +324 -0
- package/bundled-skills/linktree-link-hub/SKILL.md +453 -0
- package/bundled-skills/liuguang-banlan-ui/SKILL.md +22 -18
- package/bundled-skills/liuguang-banlan-ui/assets/starter/launcher.css +2 -2
- package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/index.html +5 -4
- package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/theme-config.js +3 -10
- package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/theme.css +48 -62
- package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/index.html +5 -4
- package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/theme-config.js +27 -35
- package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/theme.css +48 -62
- package/bundled-skills/liuguang-banlan-ui/assets/starter/shared/spectral-field.js +135 -148
- package/bundled-skills/liuguang-banlan-ui/references/style-contract.md +26 -7
- package/bundled-skills/liuguang-banlan-ui/references/verification.md +19 -7
- package/bundled-skills/liuguang-banlan-ui/scripts/measure_preview.py +78 -47
- package/bundled-skills/liuguang-banlan-ui/scripts/serve_preview.py +35 -0
- package/bundled-skills/liuguang-banlan-ui/scripts/validate_manifest.py +34 -3
- package/bundled-skills/liuguang-banlan-ui/tests/test_measure_preview.py +119 -0
- package/bundled-skills/liuguang-banlan-ui/tests/test_serve_preview.py +38 -0
- package/bundled-skills/liuguang-banlan-ui/tests/test_validate_manifest.py +73 -0
- package/bundled-skills/logo-image-design/SKILL.md +459 -0
- package/bundled-skills/loki-mode/examples/todo-app-generated/frontend/package-lock.json +12 -12
- package/bundled-skills/loki-mode/examples/todo-app-generated/frontend/package.json +1 -1
- package/bundled-skills/meeting-notes/SKILL.md +80 -0
- package/bundled-skills/mentorship-program/SKILL.md +332 -0
- package/bundled-skills/mirrord/SKILL.md +90 -0
- package/bundled-skills/monthly-closing-statements/SKILL.md +488 -0
- package/bundled-skills/monthly-closing-statements/references/related-skills.md +17 -0
- package/bundled-skills/monthly-closing-statements/references/reusable-prompt.md +8 -0
- package/bundled-skills/music-generation-studio/SKILL.md +259 -0
- package/bundled-skills/notification-reminder-hub/SKILL.md +324 -0
- package/bundled-skills/notion-manual-import/SKILL.md +376 -0
- package/bundled-skills/notion-manual-import/references/best-practices.md +10 -0
- package/bundled-skills/notion-manual-import/references/common-pitfalls.md +26 -0
- package/bundled-skills/notion-manual-import/references/input-modules.md +203 -0
- package/bundled-skills/notion-manual-import/references/related-skills.md +7 -0
- package/bundled-skills/notion-manual-import/references/reusable-prompt.md +8 -0
- package/bundled-skills/notion-manual-import/references/security-safety-notes.md +15 -0
- package/bundled-skills/observability-cloud-planning/SKILL.md +487 -0
- package/bundled-skills/observability-cloud-planning/references/common-pitfalls.md +39 -0
- package/bundled-skills/observability-cloud-planning/references/related-skills.md +20 -0
- package/bundled-skills/observability-cloud-planning/references/reusable-prompt.md +12 -0
- package/bundled-skills/observability-cloud-planning/references/security-safety-notes.md +30 -0
- package/bundled-skills/offboarding-exit/SKILL.md +343 -0
- package/bundled-skills/offer-appointment/SKILL.md +351 -0
- package/bundled-skills/okr-system/SKILL.md +355 -0
- package/bundled-skills/onboarding-playbook/SKILL.md +292 -0
- package/bundled-skills/organization-design/SKILL.md +324 -0
- package/bundled-skills/party-ledger-reconciliation/SKILL.md +411 -0
- package/bundled-skills/payment-accounting/SKILL.md +421 -0
- package/bundled-skills/payments-received/SKILL.md +315 -0
- package/bundled-skills/payroll-finance/SKILL.md +351 -0
- package/bundled-skills/people-directory/SKILL.md +459 -0
- package/bundled-skills/performance-management/SKILL.md +367 -0
- package/bundled-skills/petty-cash-management/SKILL.md +448 -0
- package/bundled-skills/policy-acknowledgement/SKILL.md +314 -0
- package/bundled-skills/policy-library/SKILL.md +327 -0
- package/bundled-skills/poster-design-studio/SKILL.md +259 -0
- package/bundled-skills/pre-boarding/SKILL.md +326 -0
- package/bundled-skills/presentation-deck/SKILL.md +491 -0
- package/bundled-skills/presentation-deck/references/related-skills.md +19 -0
- package/bundled-skills/presentation-deck/references/reusable-prompt.md +11 -0
- package/bundled-skills/probation-tracker/SKILL.md +347 -0
- package/bundled-skills/product-photo-studio/SKILL.md +259 -0
- package/bundled-skills/project-based-performance/SKILL.md +323 -0
- package/bundled-skills/projects-work-management/SKILL.md +368 -0
- package/bundled-skills/promotion-upgrade-requests/SKILL.md +377 -0
- package/bundled-skills/purchase-accounting/SKILL.md +414 -0
- package/bundled-skills/receipt-accounting/SKILL.md +424 -0
- package/bundled-skills/recognition-rewards/SKILL.md +324 -0
- package/bundled-skills/recruitment-pipeline/SKILL.md +399 -0
- package/bundled-skills/remote-work-tracker/SKILL.md +306 -0
- package/bundled-skills/repo-foundation/SKILL.md +166 -0
- package/bundled-skills/repo-foundation/references/LICENSE.md +21 -0
- package/bundled-skills/repo-foundation/references/bootstrap.md +63 -0
- package/bundled-skills/repo-foundation/references/companion.md +9 -0
- package/bundled-skills/repo-foundation/references/continuity.md +50 -0
- package/bundled-skills/repo-foundation/references/evolution.md +60 -0
- package/bundled-skills/repo-foundation/references/migration-examples.md +53 -0
- package/bundled-skills/repo-foundation/references/shared-contracts.md +48 -0
- package/bundled-skills/repo-foundation/references/verification.md +50 -0
- package/bundled-skills/repo-native-refactor/SKILL.md +225 -0
- package/bundled-skills/repo-native-refactor/references/LICENSE.md +21 -0
- package/bundled-skills/repo-native-refactor/references/deterministic-tooling.md +101 -0
- package/bundled-skills/repo-native-refactor/references/error-reliability.md +117 -0
- package/bundled-skills/repo-native-refactor/references/finding-taxonomy.md +181 -0
- package/bundled-skills/repo-native-refactor/references/refactor-examples.md +77 -0
- package/bundled-skills/repo-native-refactor/references/repository-prose.md +157 -0
- package/bundled-skills/repo-native-refactor/references/repository-rehabilitation.md +94 -0
- package/bundled-skills/repo-native-refactor/references/semantic-risk.md +187 -0
- package/bundled-skills/repo-native-refactor/references/shared-contracts.md +48 -0
- package/bundled-skills/repo-native-refactor/references/testing-integrity.md +103 -0
- package/bundled-skills/reports-analytics/SKILL.md +320 -0
- package/bundled-skills/salary-benchmarking/SKILL.md +318 -0
- package/bundled-skills/salary-wage-accounting/SKILL.md +412 -0
- package/bundled-skills/sales-accounting/SKILL.md +494 -0
- package/bundled-skills/sales-accounting/references/common-pitfalls.md +28 -0
- package/bundled-skills/sales-accounting/references/related-skills.md +13 -0
- package/bundled-skills/sales-accounting/references/reusable-prompt.md +8 -0
- package/bundled-skills/seo-directory-backlinks/SKILL.md +484 -0
- package/bundled-skills/seo-directory-backlinks/references/common-pitfalls.md +36 -0
- package/bundled-skills/seo-directory-backlinks/references/related-skills.md +15 -0
- package/bundled-skills/seo-directory-backlinks/references/reusable-prompt.md +11 -0
- package/bundled-skills/skill-gap-analysis/SKILL.md +338 -0
- package/bundled-skills/social-media-setup/SKILL.md +477 -0
- package/bundled-skills/social-media-setup/references/common-pitfalls.md +34 -0
- package/bundled-skills/social-media-setup/references/related-skills.md +19 -0
- package/bundled-skills/social-media-setup/references/reusable-prompt.md +11 -0
- package/bundled-skills/social-media-setup/references/security-safety-notes.md +27 -0
- package/bundled-skills/sop-company-wiki/SKILL.md +324 -0
- package/bundled-skills/source-document-filing/SKILL.md +368 -0
- package/bundled-skills/spreadsheet-manual-build/SKILL.md +493 -0
- package/bundled-skills/spreadsheet-manual-build/references/best-practices.md +9 -0
- package/bundled-skills/spreadsheet-manual-build/references/common-pitfalls.md +22 -0
- package/bundled-skills/spreadsheet-manual-build/references/related-skills.md +8 -0
- package/bundled-skills/spreadsheet-manual-build/references/reusable-prompt.md +9 -0
- package/bundled-skills/spreadsheet-manual-build/references/security-safety-notes.md +16 -0
- package/bundled-skills/stakeholder-investor-reports/SKILL.md +303 -0
- package/bundled-skills/suno-lyrics-to-song/SKILL.md +259 -0
- package/bundled-skills/talking-avatar-video/SKILL.md +260 -0
- package/bundled-skills/tax-register/SKILL.md +363 -0
- package/bundled-skills/tds-booking-payment/SKILL.md +405 -0
- package/bundled-skills/team-calendar/SKILL.md +312 -0
- package/bundled-skills/tech-writing-proofread/SKILL.md +78 -0
- package/bundled-skills/telegram/assets/boilerplate/nodejs/package-lock.json +3 -3
- package/bundled-skills/telegram/assets/boilerplate/nodejs/package.json +1 -0
- package/bundled-skills/template-library/SKILL.md +304 -0
- package/bundled-skills/time-tracking/SKILL.md +353 -0
- package/bundled-skills/typescript-expert/scripts/ts_diagnostic.py +40 -19
- package/bundled-skills/vendor-contractor-management/SKILL.md +327 -0
- package/bundled-skills/viral-video-teardown-remake/SKILL.md +260 -0
- package/bundled-skills/voice-cloning-studio/SKILL.md +260 -0
- package/bundled-skills/voiceover-narration-studio/SKILL.md +259 -0
- package/bundled-skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package-lock.json +3 -3
- package/bundled-skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package.json +1 -0
- package/bundled-skills/youtube-summarizer/SKILL.md +3 -3
- package/package.json +1 -1
- package/skills_index.json +254 -0
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: advanced-analytics-dashboard
|
|
3
|
+
description: 'Dashboard metric register: metric, source module, formula, period, value, target, trend, owner and last-updated, as CSV, SQL, JSON Schema or Notion on request. Use for KPI dashboards.'
|
|
4
|
+
category: business
|
|
5
|
+
risk: safe
|
|
6
|
+
source: self
|
|
7
|
+
source_type: self
|
|
8
|
+
date_added: '2026-09-26'
|
|
9
|
+
author: WHOISABHISHEKADHIKARI
|
|
10
|
+
tags:
|
|
11
|
+
- sme
|
|
12
|
+
- business
|
|
13
|
+
- operations
|
|
14
|
+
- database
|
|
15
|
+
- csv
|
|
16
|
+
- notion
|
|
17
|
+
- sql
|
|
18
|
+
- analyze
|
|
19
|
+
tools: []
|
|
20
|
+
source_repo: WHOISABHISHEKADHIKARI/sme-ops-system-builder
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
# Advanced Analytics Dashboard
|
|
24
|
+
|
|
25
|
+
**What it is:** A register for analytics metrics and their sources; it does not train or run predictive models.
|
|
26
|
+
|
|
27
|
+
## Overview
|
|
28
|
+
|
|
29
|
+
Works out the smallest useful **Advanced Analytics Dashboard** setup for the business in front of it, then
|
|
30
|
+
builds it only when asked. The default output is a short recommendation, not a
|
|
31
|
+
spreadsheet. Artifacts - CSV, SQL DDL, JSON Schema, Notion mapping - are produced on
|
|
32
|
+
request, from one field list so they cannot drift apart.
|
|
33
|
+
|
|
34
|
+
Layer: Layer 9: Analyze. Fits: Scale stage. Table code: n/a.
|
|
35
|
+
|
|
36
|
+
## When to Use This Skill
|
|
37
|
+
|
|
38
|
+
- analytics dashboard
|
|
39
|
+
- predictive metrics
|
|
40
|
+
- kpi dashboard template
|
|
41
|
+
- business metrics dashboard
|
|
42
|
+
|
|
43
|
+
Also use it when the user says "predictive insights", or describes the same process happening in a
|
|
44
|
+
spreadsheet, a document or someone inboxes.
|
|
45
|
+
|
|
46
|
+
Do not use it for: payroll calculation, tax filing, or legal advice. This skill produces
|
|
47
|
+
empty templates only - it never holds or processes real employee or customer data.
|
|
48
|
+
|
|
49
|
+
## How It Works
|
|
50
|
+
|
|
51
|
+
Follow the shared execution contract. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.
|
|
52
|
+
|
|
53
|
+
### Step 1 - Identify intent
|
|
54
|
+
|
|
55
|
+
Read the request and pick the intent before asking anything.
|
|
56
|
+
|
|
57
|
+
- "set up" or "build" or "create" -> the user wants artifacts; go to Step 2.
|
|
58
|
+
- "our process is ..." or "it is in a sheet" -> the user wants to move an existing process; capture it, then Step 2.
|
|
59
|
+
- "is this right" or "review" or "audit" -> the user wants a check, not a build; answer from what they share.
|
|
60
|
+
- "how do I ..." -> advice question; answer directly and offer the build only if it helps.
|
|
61
|
+
|
|
62
|
+
Ask only if this is the highest-value missing fact; otherwise proceed without an opener:
|
|
63
|
+
|
|
64
|
+
> **Q:** Which decision is the dashboard meant to support?
|
|
65
|
+
|
|
66
|
+
### Step 2 - Ask only what is missing
|
|
67
|
+
|
|
68
|
+
Skip anything the user already answered, in any earlier message. Ask the rest one at a
|
|
69
|
+
time, and stop as soon as the remaining answers would not change the output.
|
|
70
|
+
|
|
71
|
+
- **Decision** - Which decision? / Who makes it? / How often?
|
|
72
|
+
- **Data** - Which sources? / How many rows? / How fresh does it need to be?
|
|
73
|
+
- **Measures** - Which metrics? / How many? / Compared against what?
|
|
74
|
+
- **Current process** - Do you have a dashboard? / Manual or tool-based? / Is it trusted?
|
|
75
|
+
- **Outcome** - What do you need? / A metric set, a layout or both?
|
|
76
|
+
|
|
77
|
+
Never invent an answer. If the user does not know, record it as unknown and carry on.
|
|
78
|
+
|
|
79
|
+
### Step 3 - Hold the internal context
|
|
80
|
+
|
|
81
|
+
Hold the answers in this shape. It stays internal - it is not shown to the user unless
|
|
82
|
+
they ask, and it never carries a value the user did not give.
|
|
83
|
+
|
|
84
|
+
```yaml
|
|
85
|
+
module: advanced-analytics-dashboard
|
|
86
|
+
intent: null # setup | advice | review | fix | build | convert | export
|
|
87
|
+
scale: null # Starter | Growth | Scale, only if the answer changes it
|
|
88
|
+
areas:
|
|
89
|
+
"Decision": null
|
|
90
|
+
"Data": null
|
|
91
|
+
"Measures": null
|
|
92
|
+
"Current process": null
|
|
93
|
+
"Outcome": null
|
|
94
|
+
requested_outputs: [] # csv | sql | json | notion | xlsx - requested formats only
|
|
95
|
+
confirmed_facts: [] # only what the user actually said
|
|
96
|
+
open_questions: [] # the unanswered ones, in the order worth asking
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Step 4 - Recommend the smallest workflow
|
|
100
|
+
|
|
101
|
+
If an artifact was requested, build it after resolving essential missing facts. Otherwise give a short recommendation and offer the relevant artifact.
|
|
102
|
+
|
|
103
|
+
**Recommended approach:** Start with the decision, then add one metric per part of it. Layout is a late decision and rarely the problem.
|
|
104
|
+
|
|
105
|
+
**Why this one:** Dashboards fail from metric sprawl, not from design. Fix the decision and the metric count first, and the layout follows.
|
|
106
|
+
|
|
107
|
+
**Workflow:** Metric defined → Source data → Calculation → Refresh → Decision review
|
|
108
|
+
|
|
109
|
+
### Step 5 - Build only on request
|
|
110
|
+
|
|
111
|
+
Once the user asks for it, derive the fields from the confirmed context and emit the
|
|
112
|
+
requested artifacts. For machine-readable text, keep prose outside the data; for files,
|
|
113
|
+
provide a usable link. Report material validation failures or limitations separately.
|
|
114
|
+
|
|
115
|
+
**A selected Notion output is rendered by `notion-manual-import`, so route the
|
|
116
|
+
Notion step there.** When the user selects Notion, hand that step to
|
|
117
|
+
@notion-manual-import: it holds the CSV, the property
|
|
118
|
+
mapping, the import steps and the verification checklist, and it renders the Field
|
|
119
|
+
Reference below instead of defining a table of its own. Do not restate the mapping
|
|
120
|
+
here and do not improvise the import steps. Manual CSV and mapping outputs need no
|
|
121
|
+
connection. For requested workspace changes, follow the shared contract: verify actual
|
|
122
|
+
tool access and the target before writing. A user saying "connected" is not tool evidence.
|
|
123
|
+
Never ask for a Notion password or token.
|
|
124
|
+
|
|
125
|
+
For an Excel-compatible CSV, use UTF-8 with a byte order mark so Excel opens the
|
|
126
|
+
text correctly. A CSV is not an `.xlsx` workbook; create `.xlsx` only when the user
|
|
127
|
+
requests a workbook.
|
|
128
|
+
A CSV carries no types, so after it, name the columns
|
|
129
|
+
that need a number, date or currency format applied.
|
|
130
|
+
|
|
131
|
+
```csv
|
|
132
|
+
Metric,Category,Source Module,Formula or Method,Period,Value,Target,Trend,Owner,Last Updated,Metric ID
|
|
133
|
+
Net revenue,General,Invoices & Billing,"Revenue invoiced minus credits, divided by active clients.",2026-03,1000,100,Up 3 months running,Example Owner,2026-01-15,
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
```sql
|
|
137
|
+
CREATE TABLE advanced_analytics_dashboard (
|
|
138
|
+
metric VARCHAR(255),
|
|
139
|
+
category VARCHAR(100) NOT NULL,
|
|
140
|
+
source_module VARCHAR(255),
|
|
141
|
+
formula_or_method VARCHAR(255),
|
|
142
|
+
period VARCHAR(255),
|
|
143
|
+
value NUMERIC NOT NULL,
|
|
144
|
+
target NUMERIC NOT NULL,
|
|
145
|
+
trend VARCHAR(255),
|
|
146
|
+
owner VARCHAR(255),
|
|
147
|
+
last_updated DATE NOT NULL,
|
|
148
|
+
metric_id SERIAL PRIMARY KEY,
|
|
149
|
+
created_at TIMESTAMP DEFAULT NOW(),
|
|
150
|
+
updated_at TIMESTAMP DEFAULT NOW()
|
|
151
|
+
);
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
```json
|
|
155
|
+
{
|
|
156
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
157
|
+
"title": "Advanced Analytics Dashboard",
|
|
158
|
+
"type": "object",
|
|
159
|
+
"additionalProperties": false,
|
|
160
|
+
"properties": {
|
|
161
|
+
"Metric": { "type": "string" },
|
|
162
|
+
"Category": { "type": "string" },
|
|
163
|
+
"Source Module": { "type": "string" },
|
|
164
|
+
"Formula or Method": { "type": "string" },
|
|
165
|
+
"Period": { "type": "string" },
|
|
166
|
+
"Value": { "type": "number" },
|
|
167
|
+
"Target": { "type": "number" },
|
|
168
|
+
"Trend": { "type": "string" },
|
|
169
|
+
"Owner": { "type": "string" },
|
|
170
|
+
"Last Updated": { "type": "string", "format": "date" },
|
|
171
|
+
"Metric ID": { "type": "integer" }
|
|
172
|
+
},
|
|
173
|
+
"required": [
|
|
174
|
+
"Category",
|
|
175
|
+
"Value",
|
|
176
|
+
"Target",
|
|
177
|
+
"Last Updated"
|
|
178
|
+
]
|
|
179
|
+
}
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
```markdown
|
|
183
|
+
| CSV column | Notion property | Set after import |
|
|
184
|
+
|---|---|---|
|
|
185
|
+
| Metric | Title | Use as the database title |
|
|
186
|
+
| Category | Select (add options after import) | Convert to Select, add options: "General", "Operations", "Finance", "People", "Compliance" |
|
|
187
|
+
| Source Module | Text | Leave as Text |
|
|
188
|
+
| Formula or Method | Text | Leave as Text |
|
|
189
|
+
| Period | Text | Leave as Text |
|
|
190
|
+
| Value | Number | Convert to Number |
|
|
191
|
+
| Target | Number | Convert to Number |
|
|
192
|
+
| Trend | Text | Leave as Text |
|
|
193
|
+
| Owner | Text | Leave as Text |
|
|
194
|
+
| Last Updated | Date | Convert to Date |
|
|
195
|
+
| Metric ID | Text (preserve source ID) | Keep imported IDs as Text; optionally add a separate Unique ID property |
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
The rows above are documentation examples only. Emit empty templates unless the user explicitly requests examples. Money stays `currency`, dates stay `date`,
|
|
199
|
+
and anything pointing at another table stays `relation`.
|
|
200
|
+
|
|
201
|
+
## Field Reference
|
|
202
|
+
|
|
203
|
+
| # | Field | Type | SQL | JSON Schema | Notion | CSV example |
|
|
204
|
+
|---:|---|---|---|---|---|---|
|
|
205
|
+
| 1 | Metric | `text` | `VARCHAR(255)` | `string` | Text | `Net revenue` |
|
|
206
|
+
| 2 | Category | `select` | `VARCHAR(100)` | `string` | Select (add options after import) | `General` |
|
|
207
|
+
| 3 | Source Module | `text` | `VARCHAR(255)` | `string` | Text | `Invoices & Billing` |
|
|
208
|
+
| 4 | Formula or Method | `text` | `VARCHAR(255)` | `string` | Text | `Revenue invoiced minus credits, divided by active clients.` |
|
|
209
|
+
| 5 | Period | `text` | `VARCHAR(255)` | `string` | Text | `2026-03` |
|
|
210
|
+
| 6 | Value | `number` | `NUMERIC` | `number` | Number | `1000` |
|
|
211
|
+
| 7 | Target | `number` | `NUMERIC` | `number` | Number | `100` |
|
|
212
|
+
| 8 | Trend | `text` | `VARCHAR(255)` | `string` | Text | `Up 3 months running` |
|
|
213
|
+
| 9 | Owner | `text` | `VARCHAR(255)` | `string` | Text | `Example Owner` |
|
|
214
|
+
| 10 | Last Updated | `date` | `DATE` | `string, format: date` | Date | `2026-01-15` |
|
|
215
|
+
| 11 | Metric ID | `id` | `SERIAL PRIMARY KEY` | `integer` | Text (preserve source ID) | `(blank)` |
|
|
216
|
+
|
|
217
|
+
## Select Options
|
|
218
|
+
|
|
219
|
+
**Category**
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
General | Operations | Finance | People | Compliance
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## Relations
|
|
226
|
+
|
|
227
|
+
Link fields: none
|
|
228
|
+
|
|
229
|
+
## Examples
|
|
230
|
+
|
|
231
|
+
**Prompt**
|
|
232
|
+
|
|
233
|
+
```
|
|
234
|
+
We have a dashboard with 30 tiles that nobody uses.
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
**Context first** - one question per message, nothing already answered:
|
|
238
|
+
|
|
239
|
+
> **Q:** Which decision?
|
|
240
|
+
> **A:** Which projects need attention.
|
|
241
|
+
>
|
|
242
|
+
> **Q:** Data sources?
|
|
243
|
+
> **A:** Project tracker and accounting.
|
|
244
|
+
>
|
|
245
|
+
> **Q:** How often?
|
|
246
|
+
> **A:** Weekly.
|
|
247
|
+
|
|
248
|
+
**Recommended next step** - offered, not built:
|
|
249
|
+
|
|
250
|
+
> Start with the decision, then add one metric per part of it. Layout is a late decision and rarely the problem.
|
|
251
|
+
>
|
|
252
|
+
> Workflow: Metric defined → Source data → Calculation → Refresh → Decision review
|
|
253
|
+
>
|
|
254
|
+
> Want the CSV, SQL, JSON Schema and Notion mapping for this?
|
|
255
|
+
|
|
256
|
+
## Best Practices
|
|
257
|
+
|
|
258
|
+
- Build when requested; recommend and offer a build for advice-only requests.
|
|
259
|
+
- One question per message. A batched intake reads as a form and gets guessed at.
|
|
260
|
+
- Keep display names identical across CSV and JSON; document normalized SQL identifiers.
|
|
261
|
+
- Use `relation` for anything that points at another table, `text` only for free text.
|
|
262
|
+
- Money fields are `currency`, never `text`. Dates are `date`, never free text.
|
|
263
|
+
- If the user requests an example row, keep it obviously fake so nobody imports it as real data.
|
|
264
|
+
|
|
265
|
+
## Limitations
|
|
266
|
+
|
|
267
|
+
- Forecasts require supplied data, a specified model, evaluation evidence and uncertainty.
|
|
268
|
+
This template alone produces no predictions or verified insights.
|
|
269
|
+
|
|
270
|
+
- Empty template only. It does not compute payroll, tax, leave balances or KPIs.
|
|
271
|
+
- Notion relations need both databases imported before the link column resolves.
|
|
272
|
+
- Select options are a starting set. Rename them to match how the business talks.
|
|
273
|
+
- No automation, reminders or sync. Those need the integration layer.
|
|
274
|
+
- Does not connect to source systems, clean data or guarantee metric accuracy.
|
|
275
|
+
- Legal, tax and HR review is still required before this drives real decisions.
|
|
276
|
+
|
|
277
|
+
## Security & Safety Notes
|
|
278
|
+
|
|
279
|
+
- Never fill in real names, salaries, medical or banking data. Placeholders only.
|
|
280
|
+
- Label example rows as synthetic, and keep bank details masked.
|
|
281
|
+
- Local reads, generation commands, and validation are part of a requested artifact build.
|
|
282
|
+
External writes, messages, provisioning, and publication require authorization for that
|
|
283
|
+
action and target; existing explicit authorization does not need to be repeated.
|
|
284
|
+
- If sensitive data is supplied, avoid repeating unnecessary identifiers. Use only what
|
|
285
|
+
the requested review needs; keep generated templates empty. Do not claim deletion
|
|
286
|
+
from the conversation or service storage.
|
|
287
|
+
- Privacy, legal and disciplinary cases need a qualified human reviewer before anything
|
|
288
|
+
is acted on.
|
|
289
|
+
|
|
290
|
+
## Common Pitfalls
|
|
291
|
+
|
|
292
|
+
- **Problem:** a static mapping is described as a completed workspace build.
|
|
293
|
+
**Solution:** deliver manual mappings without a connection; claim a live change only
|
|
294
|
+
after the authorized tool operation succeeds.
|
|
295
|
+
- **Problem:** asked all six questions in one message.
|
|
296
|
+
**Solution:** ask one, wait, and drop any the first answer already covered.
|
|
297
|
+
- **Problem:** built a full system when one table was asked for.
|
|
298
|
+
**Solution:** build what was requested; mention the parent skill separately.
|
|
299
|
+
- **Problem:** all four artifacts drift apart.
|
|
300
|
+
**Solution:** derive all four from the field list in this file, never by hand.
|
|
301
|
+
- **Problem:** Notion import shows every column as Text.
|
|
302
|
+
**Solution:** that is expected. Apply the property mapping table once, after import.
|
|
303
|
+
|
|
304
|
+
## Related Skills
|
|
305
|
+
|
|
306
|
+
- [Module Catalog](https://github.com/sickn33/agentic-awesome-skills/blob/main/CATALOG.md) - find the relevant module, then read its skill.
|
|
307
|
+
- @people-directory - the employee master record most modules link to.
|
|
308
|
+
- @notification-reminder-hub - turns due dates in this module into reminders.
|
|
309
|
+
|
|
310
|
+
## Reusable Prompt
|
|
311
|
+
|
|
312
|
+
```
|
|
313
|
+
I want to set up predictive insights for my company.
|
|
314
|
+
Ask me one short question at a time, and only about what I have not already told you.
|
|
315
|
+
Then recommend the smallest setup that fits, and wait for me to ask before you build it.
|
|
316
|
+
When I ask, output CSV, SQL DDL, JSON Schema, a Notion property mapping or an Excel workbook. Data only.
|
|
317
|
+
```
|
|
318
|
+
|
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ai-image-generation-studio
|
|
3
|
+
description: "Install and use the official AI Image Generator package, pinned by digest, for paid hosted work on the Beatra service."
|
|
4
|
+
category: media
|
|
5
|
+
risk: critical
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: beatra-ai/ai-image-generator-skill
|
|
8
|
+
source_type: official
|
|
9
|
+
date_added: "2026-09-18"
|
|
10
|
+
author: beatra-ai
|
|
11
|
+
tags: [image-generation, text-to-image, mcp, paid-api, beatra]
|
|
12
|
+
tools: [claude, codex, cursor, gemini]
|
|
13
|
+
license: "MIT-0"
|
|
14
|
+
license_source: "https://github.com/beatra-ai/ai-image-generator-skill/blob/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# AI Image Generator Skill
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
Generate, compose, and edit product images, brand visuals, posters, social graphics, illustrations, and photo variations, from inside Claude Code, Codex, or OpenClaw. The work is produced on the hosted, paid Beatra service
|
|
22
|
+
(`mcp.beatra.ai`).
|
|
23
|
+
|
|
24
|
+
This catalog entry is a **reviewed pointer, not the executable package**. It
|
|
25
|
+
contains no client code and performs no Beatra operation by itself. The package
|
|
26
|
+
it points to bundles three standard-library Python scripts that make network
|
|
27
|
+
calls, store a credential, and can replace their own files. Read
|
|
28
|
+
[Install](#install-pinned-verified-approved-twice) and
|
|
29
|
+
[Security & Safety Notes](#security--safety-notes) before activating it.
|
|
30
|
+
|
|
31
|
+
| Pinned identity | Value |
|
|
32
|
+
| --- | --- |
|
|
33
|
+
| Package | `ai-image-generation-studio` `0.1.4` |
|
|
34
|
+
| Archive | `https://cdn.beatra.ai/agent-packages/ai-image-generation-studio/v0.1.4/ai-image-generation-studio-skill-0.1.4.zip` |
|
|
35
|
+
| Archive SHA-256 | `b357edb0f9f2546435c89cf1ef8278596e28a7629229a78fcab9804decd13682` |
|
|
36
|
+
| Source tree | [`beatra-ai/ai-image-generator-skill@13c7b9b`](https://github.com/beatra-ai/ai-image-generator-skill/tree/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/skills/ai-image-generation-studio) (full SHA `13c7b9b2a2197fb91deb6a3a1466124db620c3d1`) |
|
|
37
|
+
| License | MIT No Attribution (MIT-0) |
|
|
38
|
+
|
|
39
|
+
The archive holds regular files only (no symlinks, no executable bits, no
|
|
40
|
+
binaries). Confirm that with the inspect commands below. Every file must be
|
|
41
|
+
byte-identical to the source tree at the pinned commit.
|
|
42
|
+
|
|
43
|
+
## When to Use This Skill
|
|
44
|
+
|
|
45
|
+
- Use when the user explicitly wants AI Image Generator work produced on Beatra and accepts that it is paid.
|
|
46
|
+
- Use when they have agreed to send prompts and any reference images to a third party.
|
|
47
|
+
- Do not use for local-only image editing or when no paid render was approved.
|
|
48
|
+
|
|
49
|
+
## Install (pinned, verified, approved twice)
|
|
50
|
+
|
|
51
|
+
### Step 1: Download and verify into a review directory
|
|
52
|
+
|
|
53
|
+
Explain that this downloads an external package from `cdn.beatra.ai`, then ask
|
|
54
|
+
for approval. Only after approval:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
umask 077
|
|
58
|
+
review_dir="$(mktemp -d)"
|
|
59
|
+
cd "$review_dir" || exit 1
|
|
60
|
+
curl -fsSLO "https://cdn.beatra.ai/agent-packages/ai-image-generation-studio/v0.1.4/ai-image-generation-studio-skill-0.1.4.zip"
|
|
61
|
+
printf '%s %s\n' \
|
|
62
|
+
'b357edb0f9f2546435c89cf1ef8278596e28a7629229a78fcab9804decd13682' \
|
|
63
|
+
'ai-image-generation-studio-skill-0.1.4.zip' | shasum -a 256 -c -
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Stop if the check does not print `OK`. The expected digest comes from this
|
|
67
|
+
catalog entry, not from a file on the same CDN.
|
|
68
|
+
|
|
69
|
+
### Step 2: Inspect before activation
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
unzip -l ai-image-generation-studio-skill-0.1.4.zip
|
|
73
|
+
unzip -q ai-image-generation-studio-skill-0.1.4.zip
|
|
74
|
+
find ai-image-generation-studio -type l -print # expect no output
|
|
75
|
+
find ai-image-generation-studio -type f -perm -111 -print # expect no output
|
|
76
|
+
grep -n '"auto_update": True' ai-image-generation-studio/scripts/mcp_client.py
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Optionally confirm byte identity with the public source tree (a second,
|
|
80
|
+
independent host):
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
git clone --quiet --filter=blob:none --no-checkout https://github.com/beatra-ai/ai-image-generator-skill.git src
|
|
84
|
+
git -C src checkout --quiet 13c7b9b2a2197fb91deb6a3a1466124db620c3d1 -- skills/ai-image-generation-studio
|
|
85
|
+
(cd ai-image-generation-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > archive.sha
|
|
86
|
+
(cd src/skills/ai-image-generation-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > tree.sha
|
|
87
|
+
cmp archive.sha tree.sha && echo IDENTICAL
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Report to the user what the review found: `SKILL.md`, `manifest.json`, the
|
|
91
|
+
bundled Markdown references, and `scripts/authorize.py`,
|
|
92
|
+
`scripts/mcp_client.py`, `scripts/uninstall.py` (Python 3.10+, standard
|
|
93
|
+
library only, no dependency installation, no lifecycle hooks). Summarize the
|
|
94
|
+
network, credential, local-state, telemetry, and self-update behavior listed
|
|
95
|
+
under [Security & Safety Notes](#security--safety-notes).
|
|
96
|
+
|
|
97
|
+
### Step 3: Copy in and disable self-update before any other command
|
|
98
|
+
|
|
99
|
+
Ask for a **second, separate** approval, because this changes agent
|
|
100
|
+
configuration. Then copy the reviewed tree to the host's skills directory
|
|
101
|
+
(Claude Code shown; use the equivalent path for other hosts) and immediately
|
|
102
|
+
turn off silent self-update for that exact path:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
dest="$HOME/.claude/skills/ai-image-generation-studio"
|
|
106
|
+
test ! -e "$dest" || { echo "destination exists; stop and ask the user"; exit 1; }
|
|
107
|
+
cp -R ai-image-generation-studio "$dest"
|
|
108
|
+
python3 "$dest/scripts/mcp_client.py" update --auto off
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
The last command must print
|
|
112
|
+
`Automatic Beatra package updates are disabled.` It writes only
|
|
113
|
+
`~/.beatra/updates/<id>/state.json` and makes no network request. Run it
|
|
114
|
+
before `authorize.py`, `verify`, `tools`, `upload`, or `call`: in this
|
|
115
|
+
pinned version self-update is **on by default**. The setting is keyed to the
|
|
116
|
+
resolved install path, so repeat it after moving or re-copying the directory.
|
|
117
|
+
|
|
118
|
+
### Step 4: Authorize as its own decision
|
|
119
|
+
|
|
120
|
+
Authorization opens a browser sign-in and stores a bearer token. Ask first.
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
python3 "$dest/scripts/authorize.py"
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Start a new agent session if the host discovers skills only at startup.
|
|
127
|
+
|
|
128
|
+
## How It Works
|
|
129
|
+
|
|
130
|
+
1. Read the installed package's `SKILL.md` and its references; they define the
|
|
131
|
+
routes, payload shapes, and review loop.
|
|
132
|
+
2. Use free, non-billable discovery first (`beatra.models.list`, task list) to
|
|
133
|
+
read current model cards and credit estimates.
|
|
134
|
+
3. Show the user a cost card for exactly one paid call: tool, model, estimate,
|
|
135
|
+
and which files will be uploaded. Wait for explicit approval. Planning or
|
|
136
|
+
"just do it" is not approval.
|
|
137
|
+
4. Upload only files the user supplied and approved for this task, then submit
|
|
138
|
+
once with a stable `client_request_id` and poll the returned task.
|
|
139
|
+
5. Report the delivered artifact and `billing.net_charged_credits`, review the
|
|
140
|
+
result with the user, and ask again before any further paid stage.
|
|
141
|
+
|
|
142
|
+
## Examples
|
|
143
|
+
|
|
144
|
+
### Free connection check (non-billable)
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
python3 "$HOME/.claude/skills/ai-image-generation-studio/scripts/mcp_client.py" verify
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### One approved paid call
|
|
151
|
+
|
|
152
|
+
After the user approved the cost card for this exact payload, submit once with
|
|
153
|
+
a stable request id using the tool name from the installed `SKILL.md`. If the
|
|
154
|
+
response is lost, retry only with the same `client_request_id` and identical
|
|
155
|
+
arguments; never submit a replacement while the task is running.
|
|
156
|
+
|
|
157
|
+
## Update
|
|
158
|
+
|
|
159
|
+
This entry does not endorse the package's silent self-update. Keep
|
|
160
|
+
`update --auto off` in place and do not run `update --auto on` or a bare
|
|
161
|
+
`update` without explicit approval.
|
|
162
|
+
|
|
163
|
+
To move to a newer version, repeat Steps 1 to 3 for that version in a new
|
|
164
|
+
review directory, verify its digest against the matching tree in `beatra-ai/ai-image-generator-skill`
|
|
165
|
+
(a version not listed in this entry has not been reviewed here), show the
|
|
166
|
+
user the file-level changes against the installed copy, and replace the
|
|
167
|
+
directory only after approval. `update --check` reports the available version
|
|
168
|
+
from `beatra.ai` without changing files.
|
|
169
|
+
|
|
170
|
+
## Uninstall
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
dest="$HOME/.claude/skills/ai-image-generation-studio"
|
|
174
|
+
python3 "$dest/scripts/uninstall.py" --dry-run
|
|
175
|
+
python3 "$dest/scripts/uninstall.py"
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Read the JSON decision. `disconnected` means this was the last Beatra skill on
|
|
179
|
+
the device: the token was revoked (when `revoked` is `true`) and the files
|
|
180
|
+
`credentials.json`, `installation.json`, `host.json`, `skills.json`, and
|
|
181
|
+
`registrations.json` under `~/.beatra` were removed. `keep_connection` means
|
|
182
|
+
another Beatra skill still uses the shared token, which stays. Then, after
|
|
183
|
+
confirming the path with the user, delete `$dest`.
|
|
184
|
+
|
|
185
|
+
`uninstall.py` does not remove `~/.beatra/updates/`. When the decision is
|
|
186
|
+
`disconnected` and no other Beatra skill is installed, remove that directory
|
|
187
|
+
too; otherwise leave it. A token that could not be revoked expires after 15
|
|
188
|
+
days idle and can be revoked at once in the Beatra Console under Agents.
|
|
189
|
+
|
|
190
|
+
## Best Practices
|
|
191
|
+
|
|
192
|
+
- ✅ Keep one approval per paid call, per upload set, and per install step.
|
|
193
|
+
- ✅ Report net charged credits from the terminal task, not the estimate.
|
|
194
|
+
- ❌ Do not re-enable self-update or install an unreviewed version silently.
|
|
195
|
+
- ❌ Do not print, paste, or move the token out of `~/.beatra/credentials.json`.
|
|
196
|
+
- ❌ Do not retry a paid call with a new request ID after an uncertain response.
|
|
197
|
+
|
|
198
|
+
## Limitations
|
|
199
|
+
|
|
200
|
+
- Requires a Beatra account, network access, Python 3.10+, and prepaid credits.
|
|
201
|
+
- Models, prices, schemas, and availability are controlled by Beatra and its
|
|
202
|
+
upstream model providers and can change; the service is provided as is.
|
|
203
|
+
- Outputs are probabilistic, not guaranteed unique or non-infringing, and need
|
|
204
|
+
human review before publication.
|
|
205
|
+
- This catalog entry reviews only the pinned archive above. A newer version is
|
|
206
|
+
a different review.
|
|
207
|
+
|
|
208
|
+
## Security & Safety Notes
|
|
209
|
+
|
|
210
|
+
`risk: critical` is deliberate.
|
|
211
|
+
|
|
212
|
+
- **Network.** Authorization uses `api.beatra.ai`; every tool call and upload
|
|
213
|
+
goes to `mcp.beatra.ai`. With self-update left on, the client also fetches
|
|
214
|
+
`https://beatra.ai/skills/ai-image-generation-studio/install.json` and archives from
|
|
215
|
+
`cdn.beatra.ai`.
|
|
216
|
+
- **Self-update (on by default in this pinned version).** Before `verify`,
|
|
217
|
+
`tools`, `upload`, or `call`, the client checks for a newer release at most
|
|
218
|
+
once every 24 hours and, if one exists, replaces package-owned files without
|
|
219
|
+
per-update preview or approval. It pins host and path, verifies checksums
|
|
220
|
+
from Beatra's own discovery document and CDN, and rolls back on failure, but
|
|
221
|
+
those digests are not independently anchored. This entry therefore requires
|
|
222
|
+
`update --auto off` before first use, as in Step 3.
|
|
223
|
+
- **Uploads and third parties.** Prompts and uploaded media are sent to Beatra
|
|
224
|
+
and forwarded to the third-party model provider executing the task. Beatra
|
|
225
|
+
is hosted outside mainland China. See the
|
|
226
|
+
[privacy policy](https://beatra.ai/en/privacy).
|
|
227
|
+
- **Billing.** Paid tools consume prepaid credits. Credits for tasks that fail
|
|
228
|
+
for reasons attributable to Beatra or the upstream model are returned
|
|
229
|
+
automatically; otherwise purchases are non-refundable, and actual usage can
|
|
230
|
+
exceed the estimate and leave a negative balance. See the
|
|
231
|
+
[terms](https://beatra.ai/en/terms).
|
|
232
|
+
- **Credentials.** `authorize.py` runs an OAuth device flow, opens the browser,
|
|
233
|
+
and stores one bearer token in `~/.beatra/credentials.json` (directory
|
|
234
|
+
`0700`, file `0600`). The token never goes into argv, environment variables,
|
|
235
|
+
or output. It carries full Beatra scope, including `wallet:spend`, has a
|
|
236
|
+
sliding 15-day idle lifetime, and is shared by every Beatra skill on the
|
|
237
|
+
device.
|
|
238
|
+
- **Local state.** `~/.beatra/` also holds `installation.json` (random
|
|
239
|
+
installation reference), `host.json` (agent platform and hostname),
|
|
240
|
+
`skills.json` (installed Beatra skill paths), `registrations.json`, and
|
|
241
|
+
`updates/<id>/state.json` plus update backups when updates run.
|
|
242
|
+
- **Telemetry.** The device flow sends the hostname as the device name, the
|
|
243
|
+
package slug and version, and the detected agent platform (for example
|
|
244
|
+
`claude-code`, from environment variables). On first use the client makes a
|
|
245
|
+
non-billable `beatra.installations.register` call, and every tool call adds
|
|
246
|
+
`source_package_slug` and `source_platform`. There is no opt-out for these
|
|
247
|
+
fields.
|
|
248
|
+
- **Retention.** Account data is kept for the life of the account. Task
|
|
249
|
+
records, artifacts, and billing ledgers are retained after account closure
|
|
250
|
+
for audit and tax purposes.
|
|
251
|
+
- **Content rights.** Users keep rights in their inputs and receive Beatra's
|
|
252
|
+
rights in outputs; they must hold rights to uploaded media and must not
|
|
253
|
+
create deceptive impersonations.
|
|
254
|
+
|
|
255
|
+
## Additional Resources
|
|
256
|
+
|
|
257
|
+
- [Source tree at the pinned commit](https://github.com/beatra-ai/ai-image-generator-skill/tree/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/skills/ai-image-generation-studio)
|
|
258
|
+
- [Product page](https://beatra.ai/skills/ai-image-generation-studio)
|
|
259
|
+
- [Terms](https://beatra.ai/en/terms) and [privacy policy](https://beatra.ai/en/privacy)
|