armelhbobdad/oh-my-skills / .claude/skills/skf-create-stack-skill
skf-create-stack-skill
VerifiedConsolidated project stack skill with integration patterns — code-mode (analyzes manifests) or compose-mode (synthesizes from existing skills + architecture doc). Use when the user requests to "create a stack skill", "forge a stack", or "stack this project".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.8 KB |
| assets/metadata-contract.md | markdown | 2.0 KB |
| assets/provenance-map-schema.md | markdown | 5.7 KB |
| assets/stack-skill-template.md | markdown | 5.8 KB |
| customize.toml | config | 2.9 KB |
| references/compile-stack.md | markdown | 8.8 KB |
| references/compose-mode-rules.md | markdown | 4.9 KB |
| references/detect-integrations.md | markdown | 20.2 KB |
| references/detect-manifests.md | markdown | 9.0 KB |
| references/generate-output.md | markdown | 20.9 KB |
| references/health-check.md | markdown | 884 B |
| references/init.md | markdown | 13.7 KB |
| references/integration-patterns.md | markdown | 2.1 KB |
| references/invocation-contract.md | markdown | 6.2 KB |
| references/manifest-patterns.md | markdown | 6.6 KB |
| references/parallel-extract.md | markdown | 17.8 KB |
| references/rank-and-confirm.md | markdown | 8.8 KB |
| references/report.md | markdown | 9.1 KB |
| references/validate.md | markdown | 13.6 KB |
assets/stack-skill-template.md
View on GitHub# Stack Skill Template
## SKILL.md Section Structure
```markdown
---
name: {stack_name}
description: >
Stack skill for {project_name} — {lib_count} libraries with
{integration_count} integration patterns. Use when working with
this project's technology stack. NOT for: individual library usage
outside this project's conventions.
---
# {project_name} Stack Skill
> {lib_count} libraries | {integration_count} integration patterns | Forge tier: {tier}
## Integration Patterns
### Cross-Cutting Patterns
[Patterns that span 3+ libraries — middleware chains, shared config, etc.]
### Library Pair Integrations
[For each detected integration pair:]
#### {LibraryA} + {LibraryB}
**Type:** {pattern_type}
**Pattern:** {description}
**Key files:** {file_list}
**Confidence:** {T1/T1-low/T2/T3}
## Library Reference Index
| Library | Imports | Key Exports | Confidence | Reference |
|---------|---------|-------------|------------|-----------|
| {name} | {count} | {top_exports} | {tier} | [ref](references/{name}.md) |
## Per-Library Summaries
### {library_name}
**Role in stack:** {one-line description of what this library does in this project}
**Key exports used:** {comma-separated list}
**Usage pattern:** {brief pattern description}
**Confidence:** {T1/T1-low/T2/T3}
**Reference:** [ref](references/{name}.md)
## Conventions
[Project-specific conventions for library usage:]
- {convention_1}
- {convention_2}
```
## Sizing Guidance for Large Stacks
A stack capstone grows monotonically as patterns and libraries are added, so a
mature stack eventually pushes SKILL.md past skill-check's `body.max_lines`
budget (default **500**) and/or the `description` past 1024 chars. Pre-empt both
ceilings at compile time:
- **Catalog placement.** The `Library Reference Index` table and `Per-Library
Summaries` are the largest, most reference-like sections. For a **large stack**
(heuristic: **> 6 libraries OR > 6 integration patterns**, the point at which
the inline catalog crowds the 500-line budget), author both into
`references/stack-catalog.md` and leave only an inline pointer in SKILL.md (see
below). For a **small stack**, keep them inline — inline passive context yields
higher task accuracy than on-demand retrieval, and small stacks fit comfortably.
Integration Patterns and Conventions stay inline regardless (Tier 1, load-bearing).
Whenever the catalog moves into `references/stack-catalog.md`, at compile time
or in a later body-size split, its Reference links become file-relative,
`[ref]({name}.md)`, because a link resolves from the file that holds it (see
"references/stack-catalog.md Structure" below).
- **Inline pointer form** (replaces the two sections above when extracted):
```markdown
## Library Catalog
{lib_count} libraries indexed in [references/stack-catalog.md](references/stack-catalog.md) —
reference-index table + per-library summaries. Load it for a specific library's exports or role.
```
- **Description cap.** Keep `description` ≤ 1024 chars. Do NOT enumerate every
library by name; the generic "{lib_count} libraries with {integration_count}
integration patterns" form already scales. If a per-library parenthetical is
used, cap it to the top libraries by import/export count with a `+{N} more`
suffix — the full list lives in `metadata.json` `libraries[]` and the catalog.
## context-snippet.md Format (Vercel-Aligned)
Indexed format targeting ~80-120 tokens per stack:
```markdown
[{stack_name} v{version}]|root: skills/{stack_name}/
|IMPORTANT: {stack_name} — read SKILL.md before writing integration code. Do NOT rely on training data.
|stack: {dep-1}@{v1}, {dep-2}@{v2}, {dep-3}@{v3}
|integrations: {pattern-1}, {pattern-2}
|gotchas: {1-2 most critical integration pitfalls}
```
## references/stack-catalog.md Structure
Written **only for large stacks** (see Sizing Guidance) when the catalog is
extracted out of SKILL.md. Holds the two sections from the inline form with
their links rewritten: a link resolves from the file that holds it, and this
file sits in `references/` beside the per-library files, so a link to one of
them is `{name}.md` (the Reference column's `[ref]({name}.md)`). The inline
form's `references/{name}.md` would resolve to `references/references/{name}.md`
from here.
```markdown
# {project_name} Stack — Library Catalog
> Reference index + per-library summaries extracted from SKILL.md to keep the
> capstone under the body-size budget. See SKILL.md for integration patterns.
## Library Reference Index
| Library | Imports | Key Exports | Confidence | Reference |
|---------|---------|-------------|------------|-----------|
| {name} | {count} | {top_exports} | {tier} | [ref]({name}.md) |
## Per-Library Summaries
### {library_name}
**Role in stack:** {one-line description of what this library does in this project}
**Key exports used:** {comma-separated list}
**Usage pattern:** {brief pattern description}
**Confidence:** {T1/T1-low/T2/T3}
**Reference:** [ref]({name}.md)
```
## references/{library}.md Structure
```markdown
# {library_name} Reference
**Version:** {version_from_manifest}
**Import count:** {count} files *(compose-mode: replace with **Export count:** {count} exports)*
**Confidence:** {T1/T1-low/T2/T3}
## Key Exports
[Top exports used in this project with signatures]
## Usage Patterns
[How this library is typically used in this codebase]
## Common Imports
[Most frequent import statements]
```
## references/integrations/{pair}.md Structure
```markdown
# {LibraryA} + {LibraryB} Integration
**Type:** {pattern_type}
**Co-import files:** {count}
**Confidence:** {T1/T1-low/T2/T3 [composed]}
## Integration Pattern
[Detailed description of how these libraries connect]
## Key Files
[Files demonstrating the integration with line references]
## Usage Convention
[How this integration is typically structured in the project]
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |