opencode-skills-collection 3.1.0 → 3.1.1
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.
- package/bundled-skills/.antigravity-install-manifest.json +84 -1
- package/bundled-skills/android-ui-journey-testing/SKILL.md +191 -0
- package/bundled-skills/ask-matt/SKILL.md +92 -0
- package/bundled-skills/bugs-are-annoying/SKILL.md +137 -0
- package/bundled-skills/codebase-design/DEEPENING.md +37 -0
- package/bundled-skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
- package/bundled-skills/codebase-design/SKILL.md +145 -0
- package/bundled-skills/competitor-analysis/LICENSE.txt +21 -0
- package/bundled-skills/competitor-analysis/SKILL.md +434 -0
- package/bundled-skills/competitor-analysis/references/battle-card-subagent.md +127 -0
- package/bundled-skills/competitor-analysis/references/battle-card.md +91 -0
- package/bundled-skills/competitor-analysis/references/example-research.md +130 -0
- package/bundled-skills/competitor-analysis/references/report-template.html +127 -0
- package/bundled-skills/competitor-analysis/references/research-patterns.md +217 -0
- package/bundled-skills/competitor-analysis/references/workflow.md +434 -0
- package/bundled-skills/competitor-analysis/scripts/capture_screenshots.mjs +142 -0
- package/bundled-skills/competitor-analysis/scripts/compile_report.mjs +929 -0
- package/bundled-skills/competitor-analysis/scripts/extract_vs_names.mjs +140 -0
- package/bundled-skills/competitor-analysis/scripts/gate_candidates.mjs +194 -0
- package/bundled-skills/competitor-analysis/scripts/list_urls.mjs +90 -0
- package/bundled-skills/competitor-analysis/scripts/md_utils.mjs +50 -0
- package/bundled-skills/competitor-analysis/scripts/merge_partials.mjs +291 -0
- package/bundled-skills/competitor-analysis/scripts/package.json +6 -0
- package/bundled-skills/design-it/3d-ui/SKILL.md +259 -0
- package/bundled-skills/design-it/SKILL.md +170 -0
- package/bundled-skills/design-it/ai-native-ui/SKILL.md +295 -0
- package/bundled-skills/design-it/aurora-ui/SKILL.md +307 -0
- package/bundled-skills/design-it/bento-ui/SKILL.md +314 -0
- package/bundled-skills/design-it/brutalism/SKILL.md +270 -0
- package/bundled-skills/design-it/brutalist-typography/SKILL.md +287 -0
- package/bundled-skills/design-it/card-based-design/SKILL.md +262 -0
- package/bundled-skills/design-it/claymorphism/SKILL.md +287 -0
- package/bundled-skills/design-it/color-blocking/SKILL.md +278 -0
- package/bundled-skills/design-it/command-center-ui/SKILL.md +345 -0
- package/bundled-skills/design-it/cyber-y2k/SKILL.md +312 -0
- package/bundled-skills/design-it/cyberpunk-ui/SKILL.md +262 -0
- package/bundled-skills/design-it/dark-mode/SKILL.md +289 -0
- package/bundled-skills/design-it/dashboard-design/SKILL.md +331 -0
- package/bundled-skills/design-it/data-dense-design/SKILL.md +322 -0
- package/bundled-skills/design-it/duotone-design/SKILL.md +248 -0
- package/bundled-skills/design-it/editorial-design/SKILL.md +328 -0
- package/bundled-skills/design-it/flat-design/SKILL.md +221 -0
- package/bundled-skills/design-it/flat-design-2/SKILL.md +240 -0
- package/bundled-skills/design-it/floating-ui/SKILL.md +299 -0
- package/bundled-skills/design-it/frutiger-aero/SKILL.md +274 -0
- package/bundled-skills/design-it/glassmorphism/SKILL.md +272 -0
- package/bundled-skills/design-it/gradient-design/SKILL.md +309 -0
- package/bundled-skills/design-it/high-contrast/SKILL.md +288 -0
- package/bundled-skills/design-it/holographic-ui/SKILL.md +310 -0
- package/bundled-skills/design-it/isometric-design/SKILL.md +228 -0
- package/bundled-skills/design-it/layered-design/SKILL.md +247 -0
- package/bundled-skills/design-it/material-design/SKILL.md +275 -0
- package/bundled-skills/design-it/maximalism/SKILL.md +297 -0
- package/bundled-skills/design-it/minimalism/SKILL.md +267 -0
- package/bundled-skills/design-it/monochromatic-ui/SKILL.md +296 -0
- package/bundled-skills/design-it/neo-brutalism/SKILL.md +270 -0
- package/bundled-skills/design-it/neumorphism/SKILL.md +248 -0
- package/bundled-skills/design-it/retro-design/SKILL.md +283 -0
- package/bundled-skills/design-it/retro-futurism/SKILL.md +259 -0
- package/bundled-skills/design-it/sci-fi-interface/SKILL.md +309 -0
- package/bundled-skills/design-it/skeuomorphism/SKILL.md +280 -0
- package/bundled-skills/design-it/soft-pastel/SKILL.md +307 -0
- package/bundled-skills/design-it/spatial-computing-ui/SKILL.md +300 -0
- package/bundled-skills/design-it/spatial-design/SKILL.md +268 -0
- package/bundled-skills/design-it/swiss-design/SKILL.md +293 -0
- package/bundled-skills/design-it/synthwave/SKILL.md +257 -0
- package/bundled-skills/design-it/tile-design/SKILL.md +297 -0
- package/bundled-skills/design-it/typography-first/SKILL.md +247 -0
- package/bundled-skills/design-it/vaporwave/SKILL.md +331 -0
- package/bundled-skills/design-it/vibrant-maximalism/SKILL.md +291 -0
- package/bundled-skills/design-it/widget-based-design/SKILL.md +274 -0
- package/bundled-skills/design-it/y2k-design/SKILL.md +268 -0
- package/bundled-skills/diagnosing-bugs/SKILL.md +165 -0
- package/bundled-skills/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
- package/bundled-skills/docs/contributors/skill-scoring.md +235 -0
- package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
- package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
- package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/users/bundles.md +1 -1
- package/bundled-skills/docs/users/claude-code-skills.md +1 -1
- package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
- package/bundled-skills/docs/users/getting-started.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/domain-modeling/ADR-FORMAT.md +47 -0
- package/bundled-skills/domain-modeling/CONTEXT-FORMAT.md +60 -0
- package/bundled-skills/domain-modeling/SKILL.md +105 -0
- package/bundled-skills/grill-me/SKILL.md +36 -0
- package/bundled-skills/grill-with-docs/SKILL.md +36 -0
- package/bundled-skills/grilling/SKILL.md +39 -0
- package/bundled-skills/handoff/SKILL.md +45 -0
- package/bundled-skills/image-generator/.env.example +7 -0
- package/bundled-skills/image-generator/SKILL.md +509 -0
- package/bundled-skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/bundled-skills/improve-codebase-architecture/SKILL.md +97 -0
- package/bundled-skills/learn/SKILL.md +156 -0
- package/bundled-skills/lesson-generator/SKILL.md +90 -0
- package/bundled-skills/llm-council/.env.example +7 -0
- package/bundled-skills/llm-council/SKILL.md +602 -0
- package/bundled-skills/loop-library/SKILL.md +205 -0
- package/bundled-skills/loop-library/agents/openai.yaml +4 -0
- package/bundled-skills/loop-library/references/catalog.md +270 -0
- package/bundled-skills/mailtrap-managing-contacts/SKILL.md +112 -0
- package/bundled-skills/mailtrap-sending-emails/SKILL.md +167 -0
- package/bundled-skills/mailtrap-setting-up-sending-domain/SKILL.md +77 -0
- package/bundled-skills/mailtrap-testing-with-sandbox/SKILL.md +110 -0
- package/bundled-skills/prototype/LOGIC.md +79 -0
- package/bundled-skills/prototype/SKILL.md +62 -0
- package/bundled-skills/prototype/UI.md +112 -0
- package/bundled-skills/setup-matt-pocock-skills/SKILL.md +158 -0
- package/bundled-skills/setup-matt-pocock-skills/domain.md +51 -0
- package/bundled-skills/setup-matt-pocock-skills/issue-tracker-github.md +34 -0
- package/bundled-skills/setup-matt-pocock-skills/issue-tracker-gitlab.md +35 -0
- package/bundled-skills/setup-matt-pocock-skills/issue-tracker-local.md +19 -0
- package/bundled-skills/setup-matt-pocock-skills/triage-labels.md +15 -0
- package/bundled-skills/survey-generator/LICENSE +21 -0
- package/bundled-skills/survey-generator/SKILL.md +143 -0
- package/bundled-skills/survey-generator/build_artifact.py +208 -0
- package/bundled-skills/survey-generator/examples/agentic-engineering/research_bundle.json +1196 -0
- package/bundled-skills/survey-generator/examples/agentic-engineering/survey.html +706 -0
- package/bundled-skills/survey-generator/style_spec.json +85 -0
- package/bundled-skills/survey-generator/templates/research_bundle_template.json +69 -0
- package/bundled-skills/tdd/SKILL.md +139 -0
- package/bundled-skills/tdd/mocking.md +59 -0
- package/bundled-skills/tdd/refactoring.md +10 -0
- package/bundled-skills/tdd/tests.md +61 -0
- package/bundled-skills/teach/GLOSSARY-FORMAT.md +35 -0
- package/bundled-skills/teach/LEARNING-RECORD-FORMAT.md +46 -0
- package/bundled-skills/teach/MISSION-FORMAT.md +31 -0
- package/bundled-skills/teach/RESOURCES-FORMAT.md +32 -0
- package/bundled-skills/teach/SKILL.md +169 -0
- package/bundled-skills/to-issues/SKILL.md +115 -0
- package/bundled-skills/to-prd/SKILL.md +104 -0
- package/bundled-skills/tools-page-seo-optimizer/SKILL.md +616 -0
- package/bundled-skills/triage/AGENT-BRIEF.md +207 -0
- package/bundled-skills/triage/OUT-OF-SCOPE.md +105 -0
- package/bundled-skills/triage/SKILL.md +143 -0
- package/bundled-skills/vibecode-production-qa-validator/SKILL.md +371 -141
- package/bundled-skills/wiki-builder/SKILL.md +157 -0
- package/bundled-skills/wiki-builder/agents/openai.yaml +5 -0
- package/bundled-skills/wiki-builder/references/wiki-flavors.md +98 -0
- package/bundled-skills/wiki-builder/scripts/init_wiki.sh +105 -0
- package/bundled-skills/wiki-builder/templates/index.md +20 -0
- package/bundled-skills/wiki-builder/templates/maintenance-log.md +7 -0
- package/bundled-skills/wiki-builder/templates/prompts/compile-concept-page.md +12 -0
- package/bundled-skills/wiki-builder/templates/prompts/compile-index.md +11 -0
- package/bundled-skills/wiki-builder/templates/prompts/compile-source-page.md +12 -0
- package/bundled-skills/wiki-builder/templates/prompts/lint-wiki.md +10 -0
- package/bundled-skills/wiki-builder/templates/prompts/query-and-file.md +11 -0
- package/bundled-skills/wiki-builder/templates/sources.md +9 -0
- package/bundled-skills/wiki-builder/templates/wiki.config.md +53 -0
- package/bundled-skills/writing-great-skills/GLOSSARY.md +181 -0
- package/bundled-skills/writing-great-skills/SKILL.md +111 -0
- package/bundled-skills/yao-meta-skill/SKILL.md +86 -0
- package/bundled-skills/yao-meta-skill/agents/interface.yaml +26 -0
- package/bundled-skills/yao-meta-skill/manifest.json +24 -0
- package/bundled-skills/yao-meta-skill/references/artifact-design-doctrine.md +49 -0
- package/bundled-skills/yao-meta-skill/references/authoring-discipline.md +78 -0
- package/bundled-skills/yao-meta-skill/references/autonomous-adaptation.md +65 -0
- package/bundled-skills/yao-meta-skill/references/distribution-registry-method.md +60 -0
- package/bundled-skills/yao-meta-skill/references/eval-playbook.md +69 -0
- package/bundled-skills/yao-meta-skill/references/gate-selection.md +68 -0
- package/bundled-skills/yao-meta-skill/references/governance.md +134 -0
- package/bundled-skills/yao-meta-skill/references/human-review-template.md +54 -0
- package/bundled-skills/yao-meta-skill/references/intent-dialogue.md +138 -0
- package/bundled-skills/yao-meta-skill/references/iteration-philosophy.md +30 -0
- package/bundled-skills/yao-meta-skill/references/non-skill-decision-tree.md +39 -0
- package/bundled-skills/yao-meta-skill/references/operating-modes.md +107 -0
- package/bundled-skills/yao-meta-skill/references/output-eval-method.md +113 -0
- package/bundled-skills/yao-meta-skill/references/output-quality-risk.md +41 -0
- package/bundled-skills/yao-meta-skill/references/output-visual-quality.md +53 -0
- package/bundled-skills/yao-meta-skill/references/packaging-contracts.md +70 -0
- package/bundled-skills/yao-meta-skill/references/pattern-extraction-doctrine.md +76 -0
- package/bundled-skills/yao-meta-skill/references/platform-capability-matrix.md +49 -0
- package/bundled-skills/yao-meta-skill/references/prompt-engineering-doctrine.md +76 -0
- package/bundled-skills/yao-meta-skill/references/qa-ladder.md +57 -0
- package/bundled-skills/yao-meta-skill/references/reference-scan.md +126 -0
- package/bundled-skills/yao-meta-skill/references/regression-cause-taxonomy.md +80 -0
- package/bundled-skills/yao-meta-skill/references/resource-boundaries.md +120 -0
- package/bundled-skills/yao-meta-skill/references/review-studio-method.md +87 -0
- package/bundled-skills/yao-meta-skill/references/review-waiver-method.md +76 -0
- package/bundled-skills/yao-meta-skill/references/runtime-conformance-method.md +21 -0
- package/bundled-skills/yao-meta-skill/references/skill-archetypes.md +86 -0
- package/bundled-skills/yao-meta-skill/references/skill-atlas-method.md +35 -0
- package/bundled-skills/yao-meta-skill/references/skill-engineering-method.md +210 -0
- package/bundled-skills/yao-meta-skill/references/skill-ir-method.md +41 -0
- package/bundled-skills/yao-meta-skill/references/skillops-decision-policy.md +53 -0
- package/bundled-skills/yao-meta-skill/references/systems-thinking-doctrine.md +75 -0
- package/bundled-skills/yao-meta-skill/references/telemetry-drift-method.md +182 -0
- package/bundled-skills/yao-meta-skill/references/trust-security-method.md +79 -0
- package/bundled-skills/yao-meta-skill/references/user-memory-policy.md +35 -0
- package/bundled-skills/youtube-notetaker/SKILL.md +209 -0
- package/bundled-skills/youtube-notetaker/reference/artifact.html +269 -0
- package/bundled-skills/youtube-notetaker/scripts/contact_sheet.py +53 -0
- package/bundled-skills/youtube-notetaker/scripts/detect_slides.sh +19 -0
- package/bundled-skills/youtube-notetaker/scripts/download.sh +24 -0
- package/bundled-skills/youtube-notetaker/scripts/extract_slides.py +43 -0
- package/bundled-skills/youtube-notetaker/scripts/serve.py +173 -0
- package/bundled-skills/youtube-notetaker/scripts/setup.sh +27 -0
- package/bundled-skills/youtube-notetaker/scripts/verify.sh +31 -0
- package/bundled-skills/youtube-notetaker/scripts/vtt_to_transcript.py +59 -0
- package/bundled-skills/youtube-notetaker/scripts/write_library_item.py +69 -0
- package/package.json +1 -1
- package/skills_index.json +1956 -286
- package/bundled-skills/ai-md/SKILL.md +0 -523
- package/bundled-skills/atlas-contract/SKILL.md +0 -650
- package/bundled-skills/busybox-on-windows/SKILL.md +0 -40
- package/bundled-skills/monte-carlo-prevent/SKILL.md +0 -257
- package/bundled-skills/monte-carlo-prevent/references/TROUBLESHOOTING.md +0 -23
- package/bundled-skills/monte-carlo-prevent/references/parameters.md +0 -32
- package/bundled-skills/monte-carlo-prevent/references/workflows.md +0 -478
- package/bundled-skills/monte-carlo-push-ingestion/SKILL.md +0 -372
- package/bundled-skills/monte-carlo-push-ingestion/references/anomaly-detection.md +0 -87
- package/bundled-skills/monte-carlo-push-ingestion/references/custom-lineage.md +0 -203
- package/bundled-skills/monte-carlo-push-ingestion/references/direct-http-api.md +0 -207
- package/bundled-skills/monte-carlo-push-ingestion/references/prerequisites.md +0 -150
- package/bundled-skills/monte-carlo-push-ingestion/references/push-lineage.md +0 -160
- package/bundled-skills/monte-carlo-push-ingestion/references/push-metadata.md +0 -158
- package/bundled-skills/monte-carlo-push-ingestion/references/push-query-logs.md +0 -219
- package/bundled-skills/monte-carlo-push-ingestion/references/validation.md +0 -257
- package/bundled-skills/monte-carlo-push-ingestion/scripts/sample_verify.py +0 -357
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_lineage.py +0 -70
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_metadata.py +0 -65
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_query_logs.py +0 -70
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_lineage.py +0 -214
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_metadata.py +0 -160
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_query_logs.py +0 -164
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_lineage.py +0 -198
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_metadata.py +0 -193
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_query_logs.py +0 -207
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_metadata.py +0 -71
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_query_logs.py +0 -64
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_metadata.py +0 -253
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_query_logs.py +0 -149
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_metadata.py +0 -190
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_query_logs.py +0 -208
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_lineage.py +0 -83
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_metadata.py +0 -77
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_query_logs.py +0 -83
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_lineage.py +0 -240
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_metadata.py +0 -212
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_query_logs.py +0 -204
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_lineage.py +0 -192
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_metadata.py +0 -178
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_query_logs.py +0 -200
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_lineage.py +0 -119
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_metadata.py +0 -119
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_query_logs.py +0 -117
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_lineage.py +0 -265
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_metadata.py +0 -313
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_query_logs.py +0 -284
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_lineage.py +0 -309
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_metadata.py +0 -245
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_query_logs.py +0 -255
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_lineage.py +0 -78
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_metadata.py +0 -80
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_query_logs.py +0 -88
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_lineage.py +0 -235
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_metadata.py +0 -219
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_query_logs.py +0 -239
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_lineage.py +0 -178
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_metadata.py +0 -178
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_query_logs.py +0 -196
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_lineage.py +0 -154
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_metadata.py +0 -137
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_query_logs.py +0 -137
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_lineage.py +0 -349
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_metadata.py +0 -329
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_query_logs.py +0 -254
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_lineage.py +0 -307
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_metadata.py +0 -228
- package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_query_logs.py +0 -248
- package/bundled-skills/monte-carlo-push-ingestion/scripts/test_template_sdk_usage.py +0 -340
- package/bundled-skills/skill-optimizer/SKILL.md +0 -271
- package/bundled-skills/using-superpowers/SKILL.md +0 -98
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# Reference Scan Strategy
|
|
2
|
+
|
|
3
|
+
Use a short benchmark scan before deep authoring. The goal is to borrow durable patterns from strong reference objects without importing their prose, weight, or brand language into the new skill.
|
|
4
|
+
|
|
5
|
+
## Source Priority
|
|
6
|
+
|
|
7
|
+
Reference scan has two layers, and they must not be treated equally:
|
|
8
|
+
|
|
9
|
+
1. **External Benchmark Scan**
|
|
10
|
+
- primary source of patterns
|
|
11
|
+
- use high-star public GitHub repos, official docs, strong public examples, and world-class products
|
|
12
|
+
- this layer defines the upper bound for quality
|
|
13
|
+
2. **User Reference Intake**
|
|
14
|
+
- a taste-and-standard layer
|
|
15
|
+
- ask whether the user has reference repos, products, pages, prompts, or systems they admire
|
|
16
|
+
- learn only the pattern, structure, boundary, or quality bar; never copy wording or private material
|
|
17
|
+
3. **Local Fit Check**
|
|
18
|
+
- secondary calibration layer
|
|
19
|
+
- use local files only for naming, privacy, compatibility, migration, and library-fit constraints
|
|
20
|
+
- this layer should not define the main design pattern
|
|
21
|
+
|
|
22
|
+
External sources should lead. User references should sharpen direction. Local files should calibrate.
|
|
23
|
+
|
|
24
|
+
## Default Visibility
|
|
25
|
+
|
|
26
|
+
Reference synthesis should be silent by default.
|
|
27
|
+
|
|
28
|
+
- do the benchmark scan and pattern synthesis in the background
|
|
29
|
+
- convert the result into a recommendation for the user
|
|
30
|
+
- surface the full evidence only to authors and reviewers
|
|
31
|
+
- only expose the underlying tradeoffs to the user when intent is still uncertain or a real design conflict needs a decision
|
|
32
|
+
|
|
33
|
+
## Why This Step Exists
|
|
34
|
+
|
|
35
|
+
A new skill often fails because it starts from an isolated idea instead of a proven pattern. A controlled reference scan improves the package before it grows:
|
|
36
|
+
|
|
37
|
+
- better boundary design
|
|
38
|
+
- cleaner folder and metadata choices
|
|
39
|
+
- more realistic quality gates
|
|
40
|
+
- stronger portability decisions
|
|
41
|
+
- better alignment with the user's own taste and quality bar
|
|
42
|
+
|
|
43
|
+
## The Rule
|
|
44
|
+
|
|
45
|
+
Reference scanning is mandatory for:
|
|
46
|
+
|
|
47
|
+
- `Production` skills
|
|
48
|
+
- `Library` skills
|
|
49
|
+
- `Governed` skills
|
|
50
|
+
- meta-skills or packaging-heavy skills
|
|
51
|
+
|
|
52
|
+
Reference scanning is optional for:
|
|
53
|
+
|
|
54
|
+
- `Scaffold` skills
|
|
55
|
+
- one-person exploratory skills
|
|
56
|
+
|
|
57
|
+
## Scope Limit
|
|
58
|
+
|
|
59
|
+
Do not turn this into open-ended research.
|
|
60
|
+
|
|
61
|
+
- scan at most `3-5` reference objects
|
|
62
|
+
- pick from no more than `3` categories
|
|
63
|
+
- extract patterns, not long copied content
|
|
64
|
+
- stop as soon as the borrow plan is clear
|
|
65
|
+
- prefer at least `2` external benchmark objects before treating the scan as complete
|
|
66
|
+
- if the user provides references, record what they admire and what should explicitly not be copied
|
|
67
|
+
|
|
68
|
+
## Pattern Acceptance
|
|
69
|
+
|
|
70
|
+
Borrowed ideas must pass a lightweight pattern test before they shape the first package.
|
|
71
|
+
|
|
72
|
+
- `recurrence`: the pattern appears in more than one serious context or source
|
|
73
|
+
- `generativity`: the pattern can guide new cases, not just explain one example
|
|
74
|
+
- `distinctiveness`: the pattern is more specific than generic good advice
|
|
75
|
+
- `boundary`: the pattern names where not to apply it or what cost it introduces
|
|
76
|
+
|
|
77
|
+
For low-risk scaffold work, generativity plus boundary clarity can be enough. For production, library, and governed work, require more evidence before the pattern changes the package shape.
|
|
78
|
+
|
|
79
|
+
See [Pattern Extraction Doctrine](pattern-extraction-doctrine.md).
|
|
80
|
+
|
|
81
|
+
## Reference Categories
|
|
82
|
+
|
|
83
|
+
Choose the smallest relevant set:
|
|
84
|
+
|
|
85
|
+
- `method`: loops, evaluation discipline, iteration structure
|
|
86
|
+
- `structure`: package anatomy, resource boundaries, metadata patterns
|
|
87
|
+
- `execution`: operator flow, scripts, initialization and validation experience
|
|
88
|
+
- `portability`: neutral metadata, adapters, degradation strategy
|
|
89
|
+
- `domain`: workflow-specific patterns from a top example in the same problem space
|
|
90
|
+
|
|
91
|
+
## Output Format
|
|
92
|
+
|
|
93
|
+
A good scan produces a short report with:
|
|
94
|
+
|
|
95
|
+
1. current skill anchor
|
|
96
|
+
2. scan focus
|
|
97
|
+
3. external benchmark objects
|
|
98
|
+
4. user-supplied references
|
|
99
|
+
5. local fit constraints
|
|
100
|
+
6. what to borrow
|
|
101
|
+
7. what not to borrow
|
|
102
|
+
8. a compact borrow plan
|
|
103
|
+
|
|
104
|
+
## What To Borrow
|
|
105
|
+
|
|
106
|
+
Borrow:
|
|
107
|
+
|
|
108
|
+
- repeatable loops
|
|
109
|
+
- clear boundary patterns
|
|
110
|
+
- proven gate choices
|
|
111
|
+
- portable metadata ideas
|
|
112
|
+
- clear operator-facing flows
|
|
113
|
+
- high-signal examples that show the finished experience, not just the internal method
|
|
114
|
+
|
|
115
|
+
Do not borrow:
|
|
116
|
+
|
|
117
|
+
- source-specific branding
|
|
118
|
+
- long copied prose
|
|
119
|
+
- unnecessary directories
|
|
120
|
+
- quality gates that exceed the skill's risk tier
|
|
121
|
+
- platform lock-in disguised as best practice
|
|
122
|
+
- local historical habits that are weaker than public top-tier benchmarks
|
|
123
|
+
|
|
124
|
+
## Design Principle
|
|
125
|
+
|
|
126
|
+
The scan is successful only if it raises skill quality faster than it raises context cost. If benchmark material makes the new skill heavier without making it more reliable, discard it.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Regression Cause Taxonomy
|
|
2
|
+
|
|
3
|
+
This taxonomy explains how iteration regressions are classified when a description candidate is evaluated for promotion.
|
|
4
|
+
|
|
5
|
+
## Core Principle
|
|
6
|
+
|
|
7
|
+
A candidate should not be judged only by aggregate pass/fail counts. The iteration system should explain why a candidate was blocked, kept behind the current description, or promoted.
|
|
8
|
+
|
|
9
|
+
## Cause Tags
|
|
10
|
+
|
|
11
|
+
### `no_candidate_outperformed_current`
|
|
12
|
+
|
|
13
|
+
The selected winner is still the current description. No candidate earned promotion.
|
|
14
|
+
|
|
15
|
+
### `visible_holdout_regression`
|
|
16
|
+
|
|
17
|
+
The candidate regressed on the visible holdout suite by adding false positives or false negatives.
|
|
18
|
+
|
|
19
|
+
### `blind_holdout_regression`
|
|
20
|
+
|
|
21
|
+
The candidate regressed on blind holdout prompts. This blocks promotion because the failure is not only local to the tuning loop.
|
|
22
|
+
|
|
23
|
+
### `current_holdout_gap_present`
|
|
24
|
+
|
|
25
|
+
The current or selected winner still carries a visible holdout miss. Promotion may still stay on `keep_current`, but the iteration bundle should show the unresolved gap.
|
|
26
|
+
|
|
27
|
+
### `current_holdout_risk`
|
|
28
|
+
|
|
29
|
+
The visible holdout calibration still looks risky even when promotion is not blocked. This is an audit signal that the route boundary needs future work.
|
|
30
|
+
|
|
31
|
+
### `judge_blind_regression`
|
|
32
|
+
|
|
33
|
+
The rubric judge found worse blind-holdout behavior than the current or baseline description.
|
|
34
|
+
|
|
35
|
+
### `judge_blind_low_agreement`
|
|
36
|
+
|
|
37
|
+
The judge-backed blind evaluation did not produce enough agreement confidence to support promotion.
|
|
38
|
+
|
|
39
|
+
### `adversarial_regression`
|
|
40
|
+
|
|
41
|
+
The candidate performed worse on adversarial holdout prompts that simulate route collisions or disguised requests.
|
|
42
|
+
|
|
43
|
+
### `adversarial_overlap_risk`
|
|
44
|
+
|
|
45
|
+
The adversarial calibration layer reports an `overlap` risk band, meaning route boundaries are too weak for safe promotion.
|
|
46
|
+
|
|
47
|
+
### `adversarial_watch_risk`
|
|
48
|
+
|
|
49
|
+
The adversarial calibration layer reports a non-failing but cautionary risk band such as `watch` or `tight`.
|
|
50
|
+
|
|
51
|
+
### `family_instability`
|
|
52
|
+
|
|
53
|
+
At least one tracked family stops being clean under blind, judge-backed blind, or adversarial evaluation.
|
|
54
|
+
|
|
55
|
+
### `route_confusion`
|
|
56
|
+
|
|
57
|
+
The route confusion matrix shows route theft or misrouting between sibling skills.
|
|
58
|
+
|
|
59
|
+
### `route_ambiguity`
|
|
60
|
+
|
|
61
|
+
The route confusion matrix reports ambiguous cases near the configured margin-warning threshold.
|
|
62
|
+
|
|
63
|
+
### `longer_without_gain`
|
|
64
|
+
|
|
65
|
+
The candidate is materially longer than the current description without producing a better route outcome.
|
|
66
|
+
|
|
67
|
+
### `promotion_ready`
|
|
68
|
+
|
|
69
|
+
The candidate passed every promotion gate and is eligible for review and promotion.
|
|
70
|
+
|
|
71
|
+
## Usage
|
|
72
|
+
|
|
73
|
+
These cause tags should appear in:
|
|
74
|
+
|
|
75
|
+
- promotion decisions
|
|
76
|
+
- iteration bundles
|
|
77
|
+
- regression histories
|
|
78
|
+
- human review summaries
|
|
79
|
+
|
|
80
|
+
They are intended to make iteration auditable rather than merely descriptive.
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# Resource Boundary Spec
|
|
2
|
+
|
|
3
|
+
This spec defines where information belongs inside a skill package.
|
|
4
|
+
|
|
5
|
+
## Principle
|
|
6
|
+
|
|
7
|
+
Keep the main skill small enough to route and execute clearly. Move detail out of `SKILL.md` as soon as it stops helping routing or branch selection.
|
|
8
|
+
|
|
9
|
+
Do not add structure for imagined future needs. A folder, script, eval, or governance file belongs in the package only when it reduces current ambiguity, execution burden, route risk, or maintenance risk.
|
|
10
|
+
|
|
11
|
+
## Context Budget Tiers
|
|
12
|
+
|
|
13
|
+
Use the lightest budget that still fits the package.
|
|
14
|
+
|
|
15
|
+
- `scaffold`: `700` initial-load tokens
|
|
16
|
+
- `production`: `1000` initial-load tokens
|
|
17
|
+
- `library`: `1300` initial-load tokens
|
|
18
|
+
- `governed`: `1300` initial-load tokens
|
|
19
|
+
|
|
20
|
+
If `manifest.json` sets `context_budget_tier`, that tier overrides the default budget derived from lifecycle or maturity metadata. This allows a high-governance skill to keep a stricter initial-load budget than its lifecycle label alone would imply.
|
|
21
|
+
|
|
22
|
+
## Placement Rules
|
|
23
|
+
|
|
24
|
+
### Put content in `SKILL.md` when it is:
|
|
25
|
+
|
|
26
|
+
- part of the trigger surface
|
|
27
|
+
- part of the core execution skeleton
|
|
28
|
+
- part of the output contract
|
|
29
|
+
- necessary for branch selection or safe defaults
|
|
30
|
+
|
|
31
|
+
### Put content in `references/` when it is:
|
|
32
|
+
|
|
33
|
+
- domain guidance
|
|
34
|
+
- long examples
|
|
35
|
+
- policy material
|
|
36
|
+
- schemas or templates humans or agents may read on demand
|
|
37
|
+
|
|
38
|
+
### Put content in `scripts/` when it is:
|
|
39
|
+
|
|
40
|
+
- deterministic
|
|
41
|
+
- repetitive
|
|
42
|
+
- brittle if rewritten from prose
|
|
43
|
+
- easier to validate as code than as instructions
|
|
44
|
+
|
|
45
|
+
### Put content in `evals/` when:
|
|
46
|
+
|
|
47
|
+
- the skill is reused enough that routing mistakes matter
|
|
48
|
+
- near-neighbor confusion is likely
|
|
49
|
+
- quality claims should be reproducible
|
|
50
|
+
|
|
51
|
+
### Put content in `assets/` when:
|
|
52
|
+
|
|
53
|
+
- the package includes output artifacts, examples, or static files that should not bloat prompt context
|
|
54
|
+
|
|
55
|
+
## Anti-Patterns
|
|
56
|
+
|
|
57
|
+
Avoid these:
|
|
58
|
+
|
|
59
|
+
- storing long policy text directly in `SKILL.md`
|
|
60
|
+
- adding `references/` with no files that are actually used
|
|
61
|
+
- adding `scripts/` for logic that is still best expressed in prose
|
|
62
|
+
- adding `evals/` for one-off or disposable skills
|
|
63
|
+
- creating every folder by default even when empty
|
|
64
|
+
- keeping folders that are neither referenced in `SKILL.md` nor declared as factory components
|
|
65
|
+
- adding broad configuration knobs before a real variation exists
|
|
66
|
+
- adding governance or reports to make a scaffold look mature when no reuse pressure exists
|
|
67
|
+
|
|
68
|
+
## Heuristics
|
|
69
|
+
|
|
70
|
+
### `SKILL.md`
|
|
71
|
+
|
|
72
|
+
- should stay focused
|
|
73
|
+
- should not become the full knowledge base
|
|
74
|
+
- should mention any optional directory that materially affects execution
|
|
75
|
+
|
|
76
|
+
### `references/`
|
|
77
|
+
|
|
78
|
+
- should earn their keep
|
|
79
|
+
- should usually be named and discoverable from `SKILL.md`
|
|
80
|
+
|
|
81
|
+
### `scripts/`
|
|
82
|
+
|
|
83
|
+
- should exist only when deterministic logic or formatting logic is real
|
|
84
|
+
- should be referenced explicitly from `SKILL.md` when required for execution
|
|
85
|
+
|
|
86
|
+
### `evals/`
|
|
87
|
+
|
|
88
|
+
- should exist when routing or quality claims need to be defended
|
|
89
|
+
- should be skipped for disposable personal drafts
|
|
90
|
+
|
|
91
|
+
## Unused Resource Detection
|
|
92
|
+
|
|
93
|
+
`resource_boundary_check.py` warns when a non-empty optional directory appears decorative:
|
|
94
|
+
|
|
95
|
+
- the directory exists and contains files
|
|
96
|
+
- the main `SKILL.md` does not reference it
|
|
97
|
+
- and the directory is not declared in `manifest.json` factory components
|
|
98
|
+
|
|
99
|
+
This protects the package from looking more sophisticated than it actually is.
|
|
100
|
+
|
|
101
|
+
## Quality Density
|
|
102
|
+
|
|
103
|
+
The checker also reports `quality_density`, a local signal for how much governance and quality evidence is packed into the initial load budget.
|
|
104
|
+
|
|
105
|
+
It combines:
|
|
106
|
+
|
|
107
|
+
- governance score
|
|
108
|
+
- presence of evals
|
|
109
|
+
- presence of reports
|
|
110
|
+
- references and scripts
|
|
111
|
+
- interface and manifest metadata
|
|
112
|
+
- failure or test evidence
|
|
113
|
+
|
|
114
|
+
Higher density means the package is staying lean while still proving quality.
|
|
115
|
+
|
|
116
|
+
## Quality Intent
|
|
117
|
+
|
|
118
|
+
The best skill is not the one with the most files. The best skill is the smallest package that still makes the recurring job reliable, reusable, and auditable.
|
|
119
|
+
|
|
120
|
+
See [Authoring Discipline](authoring-discipline.md) for the author and reviewer rules that keep resource growth tied to a real user goal.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Review Studio 2.0 Method
|
|
2
|
+
|
|
3
|
+
Review Studio is the release-facing audit surface for a skill package. It does not replace the detailed reports; it turns them into one reviewer decision page.
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
- Show release blockers and warnings before the package deepens.
|
|
8
|
+
- Link every gate back to a concrete evidence artifact.
|
|
9
|
+
- Generate review actions for every blocker and warning, with source-fix location and verification command.
|
|
10
|
+
- Make human warning acceptance auditable through a waiver ledger.
|
|
11
|
+
- Make reviewer comments auditable through an annotation ledger tied to gates, source/report paths, and optional line numbers.
|
|
12
|
+
- Keep review flow vertical: summary first, gates second, supporting details after.
|
|
13
|
+
- Avoid hiding output quality, runtime, trust, portfolio, and operating-loop issues across separate pages.
|
|
14
|
+
|
|
15
|
+
## Required Gates
|
|
16
|
+
|
|
17
|
+
1. Intent Canvas: intent confidence and unresolved input/output/exclusion gaps.
|
|
18
|
+
2. Trigger Lab: route scorecard, misroutes, ambiguous cases, and near-neighbor safety.
|
|
19
|
+
3. Output Lab: with-skill vs baseline delta, execution mode, timing/token evidence, case count, file-backed cases, near-neighbor cases, boundary cases, blind A/B review pack evidence, and reviewer adjudication status.
|
|
20
|
+
4. Context Budget: initial load, budget tier, warnings, and quality density.
|
|
21
|
+
5. Runtime Matrix: target conformance pass/fail and degradation notes.
|
|
22
|
+
6. Trust Report: secret scan, script surface, dependency pinning, network/interactive flags, and package hash.
|
|
23
|
+
7. Permission Gates: reviewer-approved capability scope, reason, expiry, evidence, and target-enforcement notes.
|
|
24
|
+
8. Runtime Permission Probes: packaged adapter permission contracts, native-enforcement flags, metadata fallback notes, and residual risks.
|
|
25
|
+
9. Skill Atlas: route collisions, stale skills, owner gaps, and no-route opportunities.
|
|
26
|
+
10. Operations Loop: local-first metadata-only adoption, missed-trigger, bad-output, script-error, and review-drift signals.
|
|
27
|
+
11. Review Waivers: human risk approvals, active coverage, expired approvals, invalid records, and expiry policy.
|
|
28
|
+
12. Registry Audit: package metadata, install evidence, compatibility entries, and archive/source checksums.
|
|
29
|
+
13. Release Notes: promotion status, migration notes, known gaps, and next move.
|
|
30
|
+
|
|
31
|
+
## Gate Semantics
|
|
32
|
+
|
|
33
|
+
- `pass`: evidence is present and the gate is satisfied.
|
|
34
|
+
- `warn`: review can continue, but the issue must be visible before release.
|
|
35
|
+
- `block`: do not claim production, library, governed, or public readiness until fixed.
|
|
36
|
+
|
|
37
|
+
For library and governed skills, Output Lab should have at least five cases and cover file-backed, near-neighbor, and boundary scenarios.
|
|
38
|
+
|
|
39
|
+
Production, library, and governed reviews should also show a blind A/B review pack. The Review Studio gate may warn when scorecard evidence exists but no blind pack is present, because the package can prove assertions but not yet reduce reviewer bias.
|
|
40
|
+
|
|
41
|
+
When `reports/output_execution_runs.json` exists, Review Studio should show the number of variant runs, command-executed runs, model-executed runs, recorded fixtures, timing-observed runs, and token-estimated runs. Recorded fixtures are valid reproducibility evidence, but they must not be described as model-executed output evidence.
|
|
42
|
+
|
|
43
|
+
When `reports/output_review_adjudication.json` exists, Review Studio should show reviewed pairs and pending pairs. Pending reviewer decisions are acceptable as an explicit state, but they must not be counted as agreement or human review evidence. For production, library, and governed packages, pending reviewer decisions should keep the Output Lab in `warn` until reviewer decisions are recorded or the warning is explicitly accepted in the waiver ledger. Invalid adjudication records should block release because they make the blind review audit untrustworthy.
|
|
44
|
+
|
|
45
|
+
The Operations Loop must never display raw telemetry logs. It should link only to `reports/adoption_drift_report.md`; privacy or schema violations are blockers.
|
|
46
|
+
|
|
47
|
+
The Runtime Permission Probes gate is evaluated after packaging, because it reads generated target adapters. A missing probe can warn in lighter modes, but governed release should not claim target permission readiness without `reports/runtime_permission_probes.json`.
|
|
48
|
+
|
|
49
|
+
The Review Waivers gate must never convert a blocker into a pass. Waivers only cover warning-level risks, require reviewer, reason, scope, and expiry, and must link only to `reports/review_waivers.md`.
|
|
50
|
+
|
|
51
|
+
Review Annotations are not waivers. They are reviewer comments attached to a Review Studio gate plus a relative source/report path and optional line number. Use them to preserve review context, requested edits, and source-line notes. Open blocker annotations should make the Review Studio decision `blocked` until the annotation is resolved or deferred with reviewer rationale. Open warning annotations can move the package into review, but they do not create gate-specific `review_actions`; actions remain reserved for non-pass gates.
|
|
52
|
+
|
|
53
|
+
## Review Actions
|
|
54
|
+
|
|
55
|
+
Every non-pass gate must produce a `review_actions` entry in `reports/review-studio.json`. When all gates pass, `review_actions` should be an empty list and the page should explicitly say there are no blocker or warning actions.
|
|
56
|
+
|
|
57
|
+
Each action must include:
|
|
58
|
+
|
|
59
|
+
- `gate_key`
|
|
60
|
+
- `status`
|
|
61
|
+
- `summary`
|
|
62
|
+
- `why`
|
|
63
|
+
- `source_fix`
|
|
64
|
+
- `source_refs`
|
|
65
|
+
- `evidence`
|
|
66
|
+
- `verification_command`
|
|
67
|
+
|
|
68
|
+
`source_refs` must be structured entries with relative `path`, human label, kind, existence flag, best-effort line number, matched pattern, short source excerpt, and relative link when the file exists. They should point to the smallest useful report or source file, not just a broad directory. The HTML page should render the excerpt next to the link so reviewers can understand why a line anchor matters before opening the full artifact.
|
|
69
|
+
|
|
70
|
+
The HTML page should render these actions before the detailed supporting sections so a reviewer can move directly from warning to fix. Action entries do not change gate count or score; they make the current decision more operational.
|
|
71
|
+
|
|
72
|
+
For `world-class-evidence`, the action should also expose an evidence-step card for every pending evidence key. Each card should show the submission path, template path, blocked source checks, command handoff, first runbook steps, provenance requirements, success checks, evidence artifacts, and privacy boundary. These cards are collection guidance only; they must not count as accepted evidence or change world-class readiness.
|
|
73
|
+
|
|
74
|
+
## Review Annotations
|
|
75
|
+
|
|
76
|
+
`reports/review_annotations.json` is the structured ledger, and `reports/review_annotations.md` is the human-readable review note surface. Each annotation should include:
|
|
77
|
+
|
|
78
|
+
- `gate_key`
|
|
79
|
+
- `target_path`
|
|
80
|
+
- `line` when a useful source line exists
|
|
81
|
+
- `severity`
|
|
82
|
+
- `status`
|
|
83
|
+
- `reviewer`
|
|
84
|
+
- `body`
|
|
85
|
+
- optional `suggested_action`
|
|
86
|
+
|
|
87
|
+
The ledger should reject absolute paths or paths that escape the skill directory. Missing target files are allowed as visible evidence gaps, not hidden failures.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Review Waiver Method
|
|
2
|
+
|
|
3
|
+
Review waivers make human risk acceptance explicit. They are not a way to hide problems; they are a local audit record for warning-level risks that the reviewer intentionally accepts for a bounded release window.
|
|
4
|
+
|
|
5
|
+
## When To Use
|
|
6
|
+
|
|
7
|
+
Use a waiver when:
|
|
8
|
+
|
|
9
|
+
- Review Studio shows a warning that is understood and intentionally accepted.
|
|
10
|
+
- The warning cannot be fixed before release without a worse tradeoff.
|
|
11
|
+
- A reviewer can name the reason, scope, evidence, and expiry date.
|
|
12
|
+
|
|
13
|
+
Do not use a waiver for blocker gates in v0. Blockers must be fixed before production, library, governed, or public readiness is claimed. In governed mode, missing or invalid high-permission approvals are blockers and should be fixed in `security/permission_policy.json`, not waived.
|
|
14
|
+
|
|
15
|
+
## Required Fields
|
|
16
|
+
|
|
17
|
+
Every waiver must include:
|
|
18
|
+
|
|
19
|
+
- `gate_key`: the Review Studio gate being accepted.
|
|
20
|
+
- `decision`: `accepted-risk`, `false-positive`, or `temporary-exception`.
|
|
21
|
+
- `reviewer`: the accountable human or team.
|
|
22
|
+
- `reason`: a concrete reason of at least 20 characters.
|
|
23
|
+
- `created_at`: ISO date.
|
|
24
|
+
- `expires_at`: ISO date.
|
|
25
|
+
- `evidence`: optional path or note that explains the decision.
|
|
26
|
+
- `scope`: default `current-release`.
|
|
27
|
+
|
|
28
|
+
## Gate Key Policy
|
|
29
|
+
|
|
30
|
+
The waiver ledger must track the Review Studio gate universe explicitly:
|
|
31
|
+
|
|
32
|
+
- `review_studio_gate_keys`: every gate Review Studio can render.
|
|
33
|
+
- `waiverable_gate_keys`: warning gates that may receive bounded human acceptance.
|
|
34
|
+
- `non_waivable_gate_keys`: gates that must not be accepted through a waiver.
|
|
35
|
+
|
|
36
|
+
When Review Studio adds or renames a gate, update the waiver gate policy and tests in the same change. `review-waivers` and `world-class-evidence` stay non-waivable: the first is the waiver mechanism itself, and the second can only be satisfied by accepted ledger evidence.
|
|
37
|
+
|
|
38
|
+
## Release Semantics
|
|
39
|
+
|
|
40
|
+
- Invalid waiver records block Review Studio.
|
|
41
|
+
- Expired waiver records stay visible and no longer cover warnings.
|
|
42
|
+
- Active waivers cover only the exact gate key they name.
|
|
43
|
+
- A warning without an active waiver remains visible as a warning.
|
|
44
|
+
- Raw user prompts, outputs, credentials, and private transcripts must not be stored in waiver reasons.
|
|
45
|
+
|
|
46
|
+
## Commands
|
|
47
|
+
|
|
48
|
+
Render or validate the ledger:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
python3 scripts/render_review_waivers.py .
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Add a bounded approval:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
python3 scripts/yao.py review-waivers . \
|
|
58
|
+
--add-waiver \
|
|
59
|
+
--gate-key trust-report \
|
|
60
|
+
--reviewer "Yao Team" \
|
|
61
|
+
--reason "Network-capable scripts are documented and bounded for this release." \
|
|
62
|
+
--expires-at 2026-09-30
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
For a non-governed release where `permission-gates` is only a warning, the same command can name `--gate-key permission-gates`. Governed releases must instead provide reviewer, scope, reason, expiry, evidence, and target-enforcement fields in `security/permission_policy.json`.
|
|
66
|
+
|
|
67
|
+
Review Studio reads `reports/review_waivers.json` and links to `reports/review_waivers.md`.
|
|
68
|
+
|
|
69
|
+
## Candidate Actions
|
|
70
|
+
|
|
71
|
+
The waiver report also surfaces current candidate actions from local evidence:
|
|
72
|
+
|
|
73
|
+
- waiverable warning candidates, such as an `output-lab` warning caused by pending reviewer decisions or missing provider-backed runs
|
|
74
|
+
- non-waivable boundaries, especially `world-class-evidence`, where pending ledger evidence cannot be converted into completion by a waiver
|
|
75
|
+
|
|
76
|
+
A waiver can make a bounded warning auditable for a release window. It cannot count as provider-backed evidence, human adjudication, native runtime enforcement, external telemetry, or public world-class readiness.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Runtime Conformance Method
|
|
2
|
+
|
|
3
|
+
Runtime conformance turns platform compatibility from a packaging afterthought into a release gate.
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
Use this check when a skill is packaged for OpenAI, Claude, Agent Skills, VS Code / Copilot, or generic targets. The goal is not to prove that every runtime behaves identically. The goal is to prove that the package exposes enough metadata, files, and degradation notes for each runtime to consume it safely.
|
|
8
|
+
|
|
9
|
+
## V0 Checks
|
|
10
|
+
|
|
11
|
+
- `SKILL.md` exists and has frontmatter `name` and `description`.
|
|
12
|
+
- `description` stays within the 1024 character limit used by common Agent Skills clients.
|
|
13
|
+
- `manifest.json` includes name, version, owner, maturity, status, review cadence, and target platforms.
|
|
14
|
+
- `agents/interface.yaml` includes display text, default prompt, activation mode, execution context, trust metadata, adapter targets, and degradation strategy.
|
|
15
|
+
- Skill IR exists and matches the frontmatter name and description.
|
|
16
|
+
- Resources named by Skill IR are relative paths and resolve inside the package.
|
|
17
|
+
- Unsupported or lossy target behavior is represented by a degradation note.
|
|
18
|
+
|
|
19
|
+
## Reviewer Gate
|
|
20
|
+
|
|
21
|
+
A reviewer should be able to see a target matrix with pass/fail status, failures, warnings, and artifact paths. Any failed target blocks library, governed, or team-distributed release for that target.
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# Skill Archetypes
|
|
2
|
+
|
|
3
|
+
Use these archetypes to decide what kind of skill you are building before you decide how many files or gates to add.
|
|
4
|
+
|
|
5
|
+
## Scaffold
|
|
6
|
+
|
|
7
|
+
Purpose:
|
|
8
|
+
|
|
9
|
+
- quick packaging for a real but still exploratory workflow
|
|
10
|
+
|
|
11
|
+
Default assets:
|
|
12
|
+
|
|
13
|
+
- `SKILL.md`
|
|
14
|
+
- `agents/interface.yaml`
|
|
15
|
+
|
|
16
|
+
Use when:
|
|
17
|
+
|
|
18
|
+
- reuse is plausible but not proven
|
|
19
|
+
- failure cost is low
|
|
20
|
+
- the workflow is still changing
|
|
21
|
+
|
|
22
|
+
## Production
|
|
23
|
+
|
|
24
|
+
Purpose:
|
|
25
|
+
|
|
26
|
+
- compact skill for team reuse
|
|
27
|
+
|
|
28
|
+
Default assets:
|
|
29
|
+
|
|
30
|
+
- lean `SKILL.md`
|
|
31
|
+
- `agents/interface.yaml`
|
|
32
|
+
- selective `references/`
|
|
33
|
+
- selective `evals/`
|
|
34
|
+
|
|
35
|
+
Use when:
|
|
36
|
+
|
|
37
|
+
- route mistakes waste team time
|
|
38
|
+
- a checklist or focused script improves reliability
|
|
39
|
+
|
|
40
|
+
## Library
|
|
41
|
+
|
|
42
|
+
Purpose:
|
|
43
|
+
|
|
44
|
+
- shared capability with visible evidence and portability expectations
|
|
45
|
+
|
|
46
|
+
Default assets:
|
|
47
|
+
|
|
48
|
+
- route evals
|
|
49
|
+
- packaging checks
|
|
50
|
+
- manifest metadata
|
|
51
|
+
- public reports
|
|
52
|
+
|
|
53
|
+
Use when:
|
|
54
|
+
|
|
55
|
+
- the skill will be reused across teams or clients
|
|
56
|
+
- the skill is likely to have near-neighbor route collisions
|
|
57
|
+
|
|
58
|
+
## Governed
|
|
59
|
+
|
|
60
|
+
Purpose:
|
|
61
|
+
|
|
62
|
+
- high-trust skill with explicit ownership and review
|
|
63
|
+
|
|
64
|
+
Default assets:
|
|
65
|
+
|
|
66
|
+
- lifecycle metadata
|
|
67
|
+
- governance score
|
|
68
|
+
- review cadence
|
|
69
|
+
- regression history
|
|
70
|
+
- governed examples or policy references
|
|
71
|
+
|
|
72
|
+
Use when:
|
|
73
|
+
|
|
74
|
+
- the skill is operationally sensitive
|
|
75
|
+
- the skill influences incident, release, compliance, or organizational standards
|
|
76
|
+
|
|
77
|
+
## Anti-Archetypes
|
|
78
|
+
|
|
79
|
+
Do not force a request into a skill archetype when it is really:
|
|
80
|
+
|
|
81
|
+
- a one-off answer
|
|
82
|
+
- a document
|
|
83
|
+
- a brainstorm
|
|
84
|
+
- an implementation task with no reusable process
|
|
85
|
+
|
|
86
|
+
See [Non-Skill Decision Tree](non-skill-decision-tree.md).
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Skill Atlas Method
|
|
2
|
+
|
|
3
|
+
Skill Atlas is the 2.0 operating layer for a workspace that contains many skills.
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
Single-skill quality is not enough for a team library. A skill portfolio also needs to reveal route collisions, stale ownership, duplicate resources, and repeated no-route opportunities.
|
|
8
|
+
|
|
9
|
+
## V0 Checks
|
|
10
|
+
|
|
11
|
+
- Catalog every `SKILL.md` under a workspace.
|
|
12
|
+
- Extract name, description, owner, maturity, targets, updated date, and review cadence.
|
|
13
|
+
- Detect similar descriptions as route-overlap candidates.
|
|
14
|
+
- Detect duplicate skill names.
|
|
15
|
+
- Detect shared script/reference filenames as dependency signals.
|
|
16
|
+
- Flag missing owner or review metadata.
|
|
17
|
+
- Flag stale skills based on `updated_at` and `review_cadence`.
|
|
18
|
+
- Extract no-route opportunities from failure notes.
|
|
19
|
+
- Read aggregate adoption drift reports and flag telemetry drift without reading raw telemetry logs.
|
|
20
|
+
|
|
21
|
+
## Scope Policy
|
|
22
|
+
|
|
23
|
+
Atlas keeps a full catalog, but release gates should distinguish actionable library skills from examples and test fixtures.
|
|
24
|
+
|
|
25
|
+
Use `skill_atlas/policy.json` to mark path prefixes as non-actionable when they are intentionally retained as examples, evolution snapshots, embedded generated skills, or validator fixtures. Non-actionable items still appear in the full report, route matrix, stale list, and owner gap list, but Review Studio should use the actionable counts for release readiness.
|
|
26
|
+
|
|
27
|
+
## Telemetry Link
|
|
28
|
+
|
|
29
|
+
Atlas may read each skill's aggregate `reports/adoption_drift_report.json` to surface portfolio drift signals such as no telemetry for production/library/governed skills, missed triggers, bad outputs, missing resources, script errors, and review-overdue counts. It must not read or package `reports/telemetry_events.jsonl`; raw telemetry remains local-only evidence owned by the skill.
|
|
30
|
+
|
|
31
|
+
Write drift output to `skill_atlas/drift_signals.json`. Non-actionable scopes stay visible in that file and in the HTML report, but only actionable drift signals should affect release readiness.
|
|
32
|
+
|
|
33
|
+
## Reviewer Gate
|
|
34
|
+
|
|
35
|
+
Use Atlas before promoting a single skill into a shared library. If an actionable route collision, missing owner, stale governed skill, or telemetry drift signal appears, fix the portfolio boundary before adding more local complexity to one skill. Non-actionable issues should stay visible as evidence, not as release blockers.
|