fix(installer,validation): correct default path and drop dangling links v5.9.0 update

This commit is contained in:
sck_0
2026-02-20 21:27:08 +01:00
parent e36d6fd3b3
commit 96ffb7d759
96 changed files with 843 additions and 758 deletions

View File

@@ -11,26 +11,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
> **Extensive Apple design guidelines and strict validation for the entire registry.**
This release adds the official Apple Human Interface Guidelines skills suite, and enforces strict agentskills-ref metadata validation across all 882+ skills.
This release adds the official Apple Human Interface Guidelines skills suite, enforces strict agentskills-ref metadata validation across all skills, and addresses critical path resolution bugs in the CLI installer along with dangling link validation to prevent agent token waste.
### 🚀 New Skills
## 🚀 New Skills
- **Apple HIG Skills Suite** (14 skills): Comprehensive platform and UX guidelines for iOS, macOS, visionOS, watchOS, and tvOS. Pattern, components, and layout references.
### 🍎 [apple-hig-skills](skills/hig-platforms/)
### 📦 Improvements
**Comprehensive platform and UX guidelines for Apple ecosystems.**
Official guidelines covering iOS, macOS, visionOS, watchOS, and tvOS natively formatted for AI consumption.
- **Quality Bar Enforcement**: Integrated strict validation rules. The entire registry (896 skills) has been audited and retrofitted to enforce strict folder-to-name matching and concise (<200 char) descriptions.
- **Contributor Documentation**: Updated `CONTRIBUTING.md` with explicit rules for the 5-Point Quality Check based on agentskills-ref.
- **Key Feature 1**: Deep dives into spatial layout, interactions, and modalities.
- **Key Feature 2**: Component-level guidelines for status bars, dialogs, charts, and input mechanisms (Pencil, Digital Crown).
### 👥 Credits
> **Try it:** `Use @hig-platforms to review if our iPad app navigation follows standard iOS paradigms.`
---
## 📦 Improvements
- **Registry Update**: Now tracking 896 skills.
- **CLI Installer**: Fixed the default `.agent/skills` path to properly default to `~/.gemini/antigravity/skills` and added an explicit `--antigravity` flag (fixes #101).
- **Validation**: Enforced strict folder-to-name matching and concise (<200 char) descriptions based on `agentskills-ref` (fixes #97).
- **Validation**: Added build-time Markdown dangling link validation to `validate_skills.py` to prevent agents from hallucinating relative paths (fixes #102).
## 👥 Credits
A huge shoutout to our community contributors:
- **@raintree-technology** for the Apple HIG Skills (Issue #90)
- **@sergeyklay** for the skill quality validations (Issue #97)
- **@raintree-technology** for the Apple HIG Skills (PR #90)
- **@sergeyklay** for the skill quality validations (PR #97)
- **@community** for identifying installer and link bugs (Issues #101, #102)
---
_Upgrade now: `git pull origin main` to fetch the latest skills._
## [5.8.0] - 2026-02-19 - "Domain-Driven Design Suite"
> **First full DDD skill suite: strategic design, context mapping, and tactical patterns for complex domains.**

View File

@@ -22,7 +22,8 @@ function parseArgs() {
let cursor = false,
claude = false,
gemini = false,
codex = false;
codex = false,
antigravity = false;
for (let i = 0; i < a.length; i++) {
if (a[i] === "--help" || a[i] === "-h") return { help: true };
@@ -54,10 +55,23 @@ function parseArgs() {
codex = true;
continue;
}
if (a[i] === "--antigravity") {
antigravity = true;
continue;
}
if (a[i] === "install") continue;
}
return { pathArg, versionArg, tagArg, cursor, claude, gemini, codex };
return {
pathArg,
versionArg,
tagArg,
cursor,
claude,
gemini,
codex,
antigravity,
};
}
function defaultDir(opts) {
@@ -70,7 +84,9 @@ function defaultDir(opts) {
if (codexHome) return path.join(codexHome, "skills");
return path.join(HOME, ".codex", "skills");
}
return path.join(HOME, ".agent", "skills");
if (opts.antigravity)
return path.join(HOME, ".gemini", "antigravity", "skills");
return path.join(HOME, ".gemini", "antigravity", "skills");
}
function printHelp() {
@@ -82,17 +98,19 @@ antigravity-awesome-skills — installer
Clones the skills repo into your agent's skills directory.
Options:
--cursor Install to ~/.cursor/skills (Cursor)
--claude Install to ~/.claude/skills (Claude Code)
--gemini Install to ~/.gemini/skills (Gemini CLI)
--codex Install to ~/.codex/skills (Codex CLI)
--path <dir> Install to <dir> (default: ~/.agent/skills)
--cursor Install to ~/.cursor/skills (Cursor)
--claude Install to ~/.claude/skills (Claude Code)
--gemini Install to ~/.gemini/skills (Gemini CLI)
--codex Install to ~/.codex/skills (Codex CLI)
--antigravity Install to ~/.gemini/antigravity/skills (Antigravity)
--path <dir> Install to <dir> (default: ~/.gemini/antigravity/skills)
--version <ver> After clone, checkout tag v<ver> (e.g. 4.6.0 -> v4.6.0)
--tag <tag> After clone, checkout this tag (e.g. v4.6.0)
Examples:
npx antigravity-awesome-skills
npx antigravity-awesome-skills --cursor
npx antigravity-awesome-skills --antigravity
npx antigravity-awesome-skills --version 4.6.0
npx antigravity-awesome-skills --path ./my-skills
`);
@@ -206,10 +224,7 @@ function main() {
try {
fs.mkdirSync(parent, { recursive: true });
} catch (e) {
console.error(
`Cannot create parent directory: ${parent}`,
e.message,
);
console.error(`Cannot create parent directory: ${parent}`, e.message);
process.exit(1);
}
}

View File

@@ -0,0 +1,52 @@
import os
import re
def fix_dangling_links(skills_dir):
print(f"Scanning for dangling links in {skills_dir}...")
pattern = re.compile(r'\[([^\]]*)\]\(([^)]+)\)')
fixed_count = 0
for root, dirs, files in os.walk(skills_dir):
# Skip hidden directories
dirs[:] = [d for d in dirs if not d.startswith('.')]
for file in files:
if not file.endswith('.md'): continue
file_path = os.path.join(root, file)
try:
with open(file_path, 'r', encoding='utf-8') as f:
content = f.read()
except Exception:
continue
def replacer(match):
nonlocal fixed_count
text = match.group(1)
href = match.group(2)
href_clean = href.split('#')[0].strip()
# Ignore empty links, web URLs, emails, etc.
if not href_clean or href_clean.startswith(('http://', 'https://', 'mailto:', '<', '>')):
return match.group(0)
if os.path.isabs(href_clean):
return match.group(0)
target_path = os.path.normpath(os.path.join(root, href_clean))
if not os.path.exists(target_path):
# Dangling link detected. Replace markdown link with just its text.
print(f"Fixing dangling link in {os.path.relpath(file_path, skills_dir)}: {href}")
fixed_count += 1
return text
return match.group(0)
new_content = pattern.sub(replacer, content)
if new_content != content:
with open(file_path, 'w', encoding='utf-8') as f:
f.write(new_content)
print(f"Total dangling links fixed: {fixed_count}")
if __name__ == '__main__':
base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
fix_dangling_links(os.path.join(base_dir, 'skills'))

View File

@@ -102,6 +102,22 @@ def validate_skills(skills_dir, strict_mode=False):
if not security_disclaimer_pattern.search(content):
errors.append(f"🚨 {rel_path}: OFFENSIVE SKILL MISSING SECURITY DISCLAIMER! (Must contain 'AUTHORIZED USE ONLY')")
# 5. Dangling Links Validation
# Look for markdown links: [text](href)
links = re.findall(r'\[[^\]]*\]\(([^)]+)\)', content)
for link in links:
link_clean = link.split('#')[0].strip()
# Skip empty anchors, external links, and edge cases
if not link_clean or link_clean.startswith(('http://', 'https://', 'mailto:', '<', '>')):
continue
if os.path.isabs(link_clean):
continue
# Check if file exists relative to this skill file
target_path = os.path.normpath(os.path.join(root, link_clean))
if not os.path.exists(target_path):
errors.append(f"{rel_path}: Dangling link detected. Path '{link_clean}' (from '...({link})') does not exist locally.")
# Reporting
print(f"\n📊 Checked {skill_count} skills.")

View File

@@ -327,7 +327,7 @@ if __name__ == "__main__":
## Reference Files
- [references/tools.md](references/tools.md): Detailed hosted tool patterns
- [references/mcp.md](references/mcp.md): MCP integration (hosted + local)
- [references/threads.md](references/threads.md): Thread and conversation management
- [references/advanced.md](references/advanced.md): OpenAPI, citations, structured outputs
- references/tools.md: Detailed hosted tool patterns
- references/mcp.md: MCP integration (hosted + local)
- references/threads.md: Thread and conversation management
- references/advanced.md: OpenAPI, citations, structured outputs

View File

@@ -348,10 +348,10 @@ This directory contains Architecture Decision Records (ADRs) for [Project Name].
| ADR | Title | Status | Date |
|-----|-------|--------|------|
| [0001](0001-use-postgresql.md) | Use PostgreSQL as Primary Database | Accepted | 2024-01-10 |
| [0002](0002-caching-strategy.md) | Caching Strategy with Redis | Accepted | 2024-01-12 |
| [0003](0003-mongodb-user-profiles.md) | MongoDB for User Profiles | Deprecated | 2023-06-15 |
| [0020](0020-deprecate-mongodb.md) | Deprecate MongoDB | Accepted | 2024-01-15 |
| 0001 | Use PostgreSQL as Primary Database | Accepted | 2024-01-10 |
| 0002 | Caching Strategy with Redis | Accepted | 2024-01-12 |
| 0003 | MongoDB for User Profiles | Deprecated | 2023-06-15 |
| 0020 | Deprecate MongoDB | Accepted | 2024-01-15 |
## Creating a New ADR

View File

@@ -211,17 +211,17 @@ node scripts/openapi-explore.mjs --spec platform op queryDatabaseRows
## References
Read before editing:
- [references/graph-contract.md](references/graph-contract.md) - Graph schema, computed vs editable fields, lock_version
- [references/node-types.md](references/node-types.md) - Node types and config shapes
- [references/workflow-overview.md](references/workflow-overview.md) - Execution flow and states
- references/graph-contract.md - Graph schema, computed vs editable fields, lock_version
- references/node-types.md - Node types and config shapes
- references/workflow-overview.md - Execution flow and states
Other references:
- [references/execution-context.md](references/execution-context.md) - Context structure and variable substitution
- [references/triggers.md](references/triggers.md) - Trigger types and setup
- [references/app-integrations.md](references/app-integrations.md) - App integration and variable_definitions
- [references/functions-reference.md](references/functions-reference.md) - Function management
- [references/functions-payloads.md](references/functions-payloads.md) - Payload shapes for functions
- [references/databases-reference.md](references/databases-reference.md) - Database operations
- references/execution-context.md - Context structure and variable substitution
- references/triggers.md - Trigger types and setup
- references/app-integrations.md - App integration and variable_definitions
- references/functions-reference.md - Function management
- references/functions-payloads.md - Payload shapes for functions
- references/databases-reference.md - Database operations
## Assets

View File

@@ -283,9 +283,9 @@ az containerapp logs show -n <app> -g <rg> --follow # Stream logs
## Reference Files
- **Bicep patterns**: See [references/bicep-patterns.md](references/bicep-patterns.md) for Container Apps modules
- **Troubleshooting**: See [references/troubleshooting.md](references/troubleshooting.md) for common issues
- **azure.yaml schema**: See [references/azure-yaml-schema.md](references/azure-yaml-schema.md) for full options
- **Bicep patterns**: See references/bicep-patterns.md for Container Apps modules
- **Troubleshooting**: See references/troubleshooting.md for common issues
- **azure.yaml schema**: See references/azure-yaml-schema.md for full options
## Critical Reminders

View File

@@ -122,7 +122,7 @@ agent_version = client.agents.create_version(
)
```
See [references/agents.md](references/agents.md) for detailed agent patterns.
See references/agents.md for detailed agent patterns.
## Tools Overview
@@ -138,7 +138,7 @@ See [references/agents.md](references/agents.md) for detailed agent patterns.
| Memory Search | `MemorySearchTool` | Search agent memory stores |
| SharePoint | `SharepointGroundingTool` | Search SharePoint content |
See [references/tools.md](references/tools.md) for all tool patterns.
See references/tools.md for all tool patterns.
## Thread and Message Flow
@@ -179,7 +179,7 @@ for conn in connections:
connection = client.connections.get(connection_name="my-search-connection")
```
See [references/connections.md](references/connections.md) for connection patterns.
See references/connections.md for connection patterns.
## Deployments
@@ -190,7 +190,7 @@ for deployment in deployments:
print(f"{deployment.name}: {deployment.model}")
```
See [references/deployments.md](references/deployments.md) for deployment patterns.
See references/deployments.md for deployment patterns.
## Datasets and Indexes
@@ -202,7 +202,7 @@ datasets = client.datasets.list()
indexes = client.indexes.list()
```
See [references/datasets-indexes.md](references/datasets-indexes.md) for data operations.
See references/datasets-indexes.md for data operations.
## Evaluation
@@ -225,7 +225,7 @@ eval_run = openai_client.evals.runs.create(
)
```
See [references/evaluation.md](references/evaluation.md) for evaluation patterns.
See references/evaluation.md for evaluation patterns.
## Async Client
@@ -240,7 +240,7 @@ async with AIProjectClient(
# ... async operations
```
See [references/async-patterns.md](references/async-patterns.md) for async patterns.
See references/async-patterns.md for async patterns.
## Memory Stores
@@ -282,14 +282,14 @@ agent = client.agents.create_agent(
## Reference Files
- [references/agents.md](references/agents.md): Agent operations with PromptAgentDefinition
- [references/tools.md](references/tools.md): All agent tools with examples
- [references/evaluation.md](references/evaluation.md): Evaluation operations overview
- [references/built-in-evaluators.md](references/built-in-evaluators.md): Complete built-in evaluator reference
- [references/custom-evaluators.md](references/custom-evaluators.md): Code and prompt-based evaluator patterns
- [references/connections.md](references/connections.md): Connection operations
- [references/deployments.md](references/deployments.md): Deployment enumeration
- [references/datasets-indexes.md](references/datasets-indexes.md): Dataset and index operations
- [references/async-patterns.md](references/async-patterns.md): Async client usage
- [references/api-reference.md](references/api-reference.md): Complete API reference for all 373 SDK exports (v2.0.0b4)
- [scripts/run_batch_evaluation.py](scripts/run_batch_evaluation.py): CLI tool for batch evaluations
- references/agents.md: Agent operations with PromptAgentDefinition
- references/tools.md: All agent tools with examples
- references/evaluation.md: Evaluation operations overview
- references/built-in-evaluators.md: Complete built-in evaluator reference
- references/custom-evaluators.md: Code and prompt-based evaluator patterns
- references/connections.md: Connection operations
- references/deployments.md: Deployment enumeration
- references/datasets-indexes.md: Dataset and index operations
- references/async-patterns.md: Async client usage
- references/api-reference.md: Complete API reference for all 373 SDK exports (v2.0.0b4)
- scripts/run_batch_evaluation.py: CLI tool for batch evaluations

View File

@@ -304,6 +304,6 @@ except ConnectionError as e:
## References
- **Detailed API Reference**: See [references/api-reference.md](references/api-reference.md)
- **Complete Examples**: See [references/examples.md](references/examples.md)
- **All Models & Types**: See [references/models.md](references/models.md)
- **Detailed API Reference**: See references/api-reference.md
- **Complete Examples**: See references/examples.md
- **All Models & Types**: See references/models.md

View File

@@ -108,7 +108,7 @@ async def get_container():
return _cosmos_container
```
**Full implementation**: See [references/client-setup.md](references/client-setup.md)
**Full implementation**: See references/client-setup.md
### 2. Pydantic Model Hierarchy
@@ -148,7 +148,7 @@ class ProjectService:
return self._doc_to_model(doc)
```
**Full patterns**: See [references/service-layer.md](references/service-layer.md)
**Full patterns**: See references/service-layer.md
## Core Principles
@@ -191,25 +191,25 @@ async def test_get_project_by_id_returns_project(mock_cosmos_container):
assert result.name == "Test"
```
**Full testing guide**: See [references/testing.md](references/testing.md)
**Full testing guide**: See references/testing.md
## Reference Files
| File | When to Read |
|------|--------------|
| [references/client-setup.md](references/client-setup.md) | Setting up Cosmos client with dual auth, SSL config, singleton pattern |
| [references/service-layer.md](references/service-layer.md) | Implementing full service class with CRUD, conversions, graceful degradation |
| [references/testing.md](references/testing.md) | Writing pytest tests, mocking Cosmos, integration test setup |
| [references/partitioning.md](references/partitioning.md) | Choosing partition keys, cross-partition queries, move operations |
| [references/error-handling.md](references/error-handling.md) | Handling CosmosResourceNotFoundError, logging, HTTP error mapping |
| references/client-setup.md | Setting up Cosmos client with dual auth, SSL config, singleton pattern |
| references/service-layer.md | Implementing full service class with CRUD, conversions, graceful degradation |
| references/testing.md | Writing pytest tests, mocking Cosmos, integration test setup |
| references/partitioning.md | Choosing partition keys, cross-partition queries, move operations |
| references/error-handling.md | Handling CosmosResourceNotFoundError, logging, HTTP error mapping |
## Template Files
| File | Purpose |
|------|---------|
| [assets/cosmos_client_template.py](assets/cosmos_client_template.py) | Ready-to-use client module |
| [assets/service_template.py](assets/service_template.py) | Service class skeleton |
| [assets/conftest_template.py](assets/conftest_template.py) | pytest fixtures for Cosmos mocking |
| assets/cosmos_client_template.py | Ready-to-use client module |
| assets/service_template.py | Service class skeleton |
| assets/conftest_template.py | pytest fixtures for Cosmos mocking |
## Quality Attributes (NFRs)

View File

@@ -275,6 +275,6 @@ except CosmosHttpResponseError as e:
| File | Contents |
|------|----------|
| [references/partitioning.md](references/partitioning.md) | Partition key strategies, hierarchical keys, hot partition detection and mitigation |
| [references/query-patterns.md](references/query-patterns.md) | Query optimization, aggregations, pagination, transactions, change feed |
| [scripts/setup_cosmos_container.py](scripts/setup_cosmos_container.py) | CLI tool for creating containers with partitioning, throughput, and indexing |
| references/partitioning.md | Partition key strategies, hierarchical keys, hot partition detection and mitigation |
| references/query-patterns.md | Query optimization, aggregations, pagination, transactions, change feed |
| scripts/setup_cosmos_container.py | CLI tool for creating containers with partitioning, throughput, and indexing |

View File

@@ -235,6 +235,6 @@ with producer:
| File | Contents |
|------|----------|
| [references/checkpointing.md](references/checkpointing.md) | Checkpoint store patterns, blob checkpointing, checkpoint strategies |
| [references/partitions.md](references/partitions.md) | Partition management, load balancing, starting positions |
| [scripts/setup_consumer.py](scripts/setup_consumer.py) | CLI for Event Hub info, consumer setup, and event sending/receiving |
| references/checkpointing.md | Checkpoint store patterns, blob checkpointing, checkpoint strategies |
| references/partitions.md | Partition management, load balancing, starting positions |
| scripts/setup_consumer.py | CLI for Event Hub info, consumer setup, and event sending/receiving |

View File

@@ -296,10 +296,10 @@ catch (RequestFailedException ex)
| File | When to Read |
|------|--------------|
| [references/service-management.md](references/service-management.md) | Service CRUD, SKUs, networking, backup/restore |
| [references/apis-operations.md](references/apis-operations.md) | APIs, operations, schemas, versioning |
| [references/products-subscriptions.md](references/products-subscriptions.md) | Products, subscriptions, access control |
| [references/policies.md](references/policies.md) | Policy XML patterns, scopes, common policies |
| references/service-management.md | Service CRUD, SKUs, networking, backup/restore |
| references/apis-operations.md | APIs, operations, schemas, versioning |
| references/products-subscriptions.md | Products, subscriptions, access control |
| references/policies.md | Policy XML patterns, scopes, common policies |
## Related Resources

View File

@@ -211,7 +211,7 @@ try {
## Querying Uploaded Logs
Use [azure-monitor-query](../query/SKILL.md) to query ingested logs:
Use azure-monitor-query to query ingested logs:
```java
// See azure-monitor-query skill for LogsQueryClient usage

View File

@@ -238,9 +238,9 @@ catch (RequestFailedException ex)
| File | When to Read |
|------|--------------|
| [references/account-management.md](references/account-management.md) | Account CRUD, failover, keys, connection strings, networking |
| [references/sql-resources.md](references/sql-resources.md) | SQL databases, containers, stored procedures, triggers, UDFs |
| [references/throughput.md](references/throughput.md) | Manual/autoscale throughput, migration between modes |
| references/account-management.md | Account CRUD, failover, keys, connection strings, networking |
| references/sql-resources.md | SQL databases, containers, stored procedures, triggers, UDFs |
| references/throughput.md | Manual/autoscale throughput, migration between modes |
## Related SDKs

View File

@@ -306,9 +306,9 @@ catch (RequestFailedException ex)
| File | When to Read |
|------|--------------|
| [references/server-management.md](references/server-management.md) | Server CRUD, admin credentials, Azure AD auth, networking |
| [references/database-operations.md](references/database-operations.md) | Database CRUD, scaling, backup, restore, copy |
| [references/elastic-pools.md](references/elastic-pools.md) | Pool management, adding/removing databases, scaling |
| references/server-management.md | Server CRUD, admin credentials, Azure AD auth, networking |
| references/database-operations.md | Database CRUD, scaling, backup, restore, copy |
| references/elastic-pools.md | Pool management, adding/removing databases, scaling |
## Related SDKs

View File

@@ -207,7 +207,7 @@ var suggestions = await searchClient.SuggestAsync<Hotel>("lux", "suggester-name"
## Vector Search
See [references/vector-search.md](references/vector-search.md) for detailed patterns.
See references/vector-search.md for detailed patterns.
```csharp
using Azure.Search.Documents.Models;
@@ -232,7 +232,7 @@ var results = await searchClient.SearchAsync<Hotel>(null, options);
## Semantic Search
See [references/semantic-search.md](references/semantic-search.md) for detailed patterns.
See references/semantic-search.md for detailed patterns.
```csharp
var options = new SearchOptions
@@ -335,5 +335,5 @@ catch (RequestFailedException ex)
| File | Contents |
|------|----------|
| [references/vector-search.md](references/vector-search.md) | Vector search, hybrid search, vectorizers |
| [references/semantic-search.md](references/semantic-search.md) | Semantic ranking, captions, answers |
| references/vector-search.md | Vector search, hybrid search, vectorizers |
| references/semantic-search.md | Semantic ranking, captions, answers |

View File

@@ -309,9 +309,9 @@ indexer_client.create_or_update_indexer(indexer)
| File | Contents |
|------|----------|
| [references/vector-search.md](references/vector-search.md) | HNSW configuration, integrated vectorization, multi-vector queries |
| [references/semantic-ranking.md](references/semantic-ranking.md) | Semantic configuration, captions, answers, hybrid patterns |
| [scripts/setup_vector_index.py](scripts/setup_vector_index.py) | CLI script to create vector-enabled search index |
| references/vector-search.md | HNSW configuration, integrated vectorization, multi-vector queries |
| references/semantic-ranking.md | Semantic configuration, captions, answers, hybrid patterns |
| scripts/setup_vector_index.py | CLI script to create vector-enabled search index |
---
@@ -470,7 +470,7 @@ results = search_client.search(
## Agentic Retrieval (Knowledge Bases)
For LLM-powered Q&A with answer synthesis, see [references/agentic-retrieval.md](references/agentic-retrieval.md).
For LLM-powered Q&A with answer synthesis, see references/agentic-retrieval.md.
Key concepts:
- **Knowledge Source**: Points to a search index

View File

@@ -262,6 +262,6 @@ with ServiceBusClient(
| File | Contents |
|------|----------|
| [references/patterns.md](references/patterns.md) | Competing consumers, sessions, retry patterns, request-response, transactions |
| [references/dead-letter.md](references/dead-letter.md) | DLQ handling, poison messages, reprocessing strategies |
| [scripts/setup_servicebus.py](scripts/setup_servicebus.py) | CLI for queue/topic/subscription management and DLQ monitoring |
| references/patterns.md | Competing consumers, sessions, retry patterns, request-response, transactions |
| references/dead-letter.md | DLQ handling, poison messages, reprocessing strategies |
| scripts/setup_servicebus.py | CLI for queue/topic/subscription management and DLQ monitoring |

View File

@@ -229,5 +229,5 @@ const receiver = client.createReceiver("my-queue", { receiveMode: "receiveAndDel
For detailed patterns, see:
- [Queues vs Topics Patterns](references/queues-topics.md) - Queue/topic patterns, sessions, receive modes, message settlement
- [Error Handling and Reliability](references/error-handling.md) - ServiceBusError codes, DLQ handling, lock renewal, graceful shutdown
- Queues vs Topics Patterns - Queue/topic patterns, sessions, receive modes, message settlement
- Error Handling and Reliability - ServiceBusError codes, DLQ handling, lock renewal, graceful shutdown

View File

@@ -369,4 +369,4 @@ Use the Speech SDK or Batch Transcription API instead when you need:
| File | Contents |
|------|----------|
| [references/pronunciation-assessment.md](references/pronunciation-assessment.md) | Pronunciation assessment parameters and scoring |
| references/pronunciation-assessment.md | Pronunciation assessment parameters and scoring |

View File

@@ -446,6 +446,6 @@ async findByEmail(email: string): Promise<User | null> {
---
**Related Files:**
- [SKILL.md](SKILL.md) - Main guide
- SKILL.md - Main guide
- [routing-and-controllers.md](routing-and-controllers.md) - Routes and controllers details
- [services-and-repositories.md](services-and-repositories.md) - Service and repository patterns

View File

@@ -302,6 +302,6 @@ process.on('uncaughtException', (error) => {
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [sentry-and-monitoring.md](sentry-and-monitoring.md)
- [complete-examples.md](complete-examples.md)

View File

@@ -632,7 +632,7 @@ Controller formats response
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [routing-and-controllers.md](routing-and-controllers.md)
- [services-and-repositories.md](services-and-repositories.md)
- [validation-patterns.md](validation-patterns.md)

View File

@@ -271,5 +271,5 @@ const jwtSecret = config.tokens.jwt;
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [testing-guide.md](testing-guide.md)

View File

@@ -219,6 +219,6 @@ try {
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [services-and-repositories.md](services-and-repositories.md)
- [async-and-errors.md](async-and-errors.md)

View File

@@ -208,6 +208,6 @@ app.use(Sentry.Handlers.errorHandler());
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [routing-and-controllers.md](routing-and-controllers.md)
- [async-and-errors.md](async-and-errors.md)

View File

@@ -751,6 +751,6 @@ export class ActionRepository {
---
**Related Files:**
- [SKILL.md](SKILL.md) - Main guide
- SKILL.md - Main guide
- [services-and-repositories.md](services-and-repositories.md) - Service layer details
- [complete-examples.md](complete-examples.md) - Full refactoring examples

View File

@@ -331,6 +331,6 @@ async function good() {
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [routing-and-controllers.md](routing-and-controllers.md)
- [async-and-errors.md](async-and-errors.md)

View File

@@ -783,7 +783,7 @@ describe('UserService', () => {
---
**Related Files:**
- [SKILL.md](SKILL.md) - Main guide
- SKILL.md - Main guide
- [routing-and-controllers.md](routing-and-controllers.md) - Controllers that use services
- [database-patterns.md](database-patterns.md) - Prisma and repository patterns
- [complete-examples.md](complete-examples.md) - Full service/repository examples

View File

@@ -230,6 +230,6 @@ npm test -- --coverage
---
**Related Files:**
- [SKILL.md](SKILL.md)
- SKILL.md
- [services-and-repositories.md](services-and-repositories.md)
- [complete-examples.md](complete-examples.md)

View File

@@ -748,7 +748,7 @@ router.post('/users',
---
**Related Files:**
- [SKILL.md](SKILL.md) - Main guide
- SKILL.md - Main guide
- [routing-and-controllers.md](routing-and-controllers.md) - Using validation in controllers
- [services-and-repositories.md](services-and-repositories.md) - Using DTOs in services
- [async-and-errors.md](async-and-errors.md) - Error handling patterns

View File

@@ -49,8 +49,8 @@ metadata:
This component contains the following code-level elements:
- [c4-code-file-1.md](./c4-code-file-1.md) - [Description]
- [c4-code-file-2.md](./c4-code-file-2.md) - [Description]
- c4-code-file-1.md - [Description]
- c4-code-file-2.md - [Description]
## Interfaces
@@ -114,12 +114,12 @@ C4Component
### [Component 1]
- **Name**: [Component name]
- **Description**: [Short description]
- **Documentation**: [c4-component-name-1.md](./c4-component-name-1.md)
- **Documentation**: c4-component-name-1.md
### [Component 2]
- **Name**: [Component name]
- **Description**: [Short description]
- **Documentation**: [c4-component-name-2.md](./c4-component-name-2.md)
- **Documentation**: c4-component-name-2.md
## Component Relationships
[Mermaid diagram showing all components and their relationships]

View File

@@ -47,7 +47,7 @@ metadata:
This container deploys the following components:
- [Component Name]: [Description]
- Documentation: [c4-component-name.md](./c4-component-name.md)
- Documentation: c4-component-name.md
## Interfaces

View File

@@ -86,8 +86,8 @@ metadata:
## Related Documentation
- [Container Documentation](./c4-container.md)
- [Component Documentation](./c4-component.md)
- Container Documentation
- Component Documentation
```
## Context Diagram Template

View File

@@ -359,7 +359,7 @@ pytest --cov=your_package
## License
This project is licensed under the ${LICENSE} License - see the [LICENSE](LICENSE) file for details.
This project is licensed under the ${LICENSE} License - see the LICENSE file for details.
```
### Example 5: Function Documentation Generator

View File

@@ -299,7 +299,7 @@ Type 'YES' to proceed, or anything else to cancel:
**Reason:** {reason}
**Archived:** YYYY-MM-DD
**Folder:** [./tracks/\_archive/{track-id}/](./tracks/_archive/{track-id}/)
**Folder:** ./tracks/\_archive/{track-id}/
```
5. Git commit:

View File

@@ -261,7 +261,7 @@ After spec approval, generate `conductor/tracks/{trackId}/plan.md`:
# Implementation Plan: {Track Title}
**Track ID:** {trackId}
**Spec:** [spec.md](./spec.md)
**Spec:** spec.md
**Created:** {YYYY-MM-DD}
**Status:** [ ] Not Started
@@ -385,8 +385,8 @@ After plan approval:
## Documents
- [Specification](./spec.md)
- [Implementation Plan](./plan.md)
- Specification
- Implementation Plan
## Progress
@@ -395,8 +395,8 @@ After plan approval:
## Quick Links
- [Back to Tracks](../../tracks.md)
- [Product Context](../../product.md)
- Back to Tracks
- Product Context
```
4. Register in `conductor/tracks.md`:

View File

@@ -308,11 +308,11 @@ Navigation hub for project context.
## Quick Links
- [Product Definition](./product.md)
- [Product Guidelines](./product-guidelines.md)
- [Tech Stack](./tech-stack.md)
- [Workflow](./workflow.md)
- [Tracks](./tracks.md)
- Product Definition
- Product Guidelines
- Tech Stack
- Workflow
- Tracks
## Active Tracks

View File

@@ -243,7 +243,7 @@ This skill connects to several others in the collection:
## References
Internal reference:
- [Evaluation Framework Reference](./references/evaluation-framework.md) - Detailed probe types and scoring rubrics
- Evaluation Framework Reference - Detailed probe types and scoring rubrics
Related skills in this collection:
- context-degradation - Understanding what compression prevents

View File

@@ -216,7 +216,7 @@ This skill builds on context-fundamentals and should be studied after understand
## References
Internal reference:
- [Degradation Patterns Reference](./references/patterns.md) - Detailed technical reference
- Degradation Patterns Reference - Detailed technical reference
Related skills in this collection:
- context-fundamentals - Context basics

View File

@@ -171,7 +171,7 @@ This skill provides foundational context that all other skills build upon. It sh
## References
Internal reference:
- [Context Components Reference](./references/context-components.md) - Detailed technical reference
- Context Components Reference - Detailed technical reference
Related skills in this collection:
- context-degradation - Understanding context failure patterns

View File

@@ -164,7 +164,7 @@ This skill builds on context-fundamentals and context-degradation. It connects t
## References
Internal reference:
- [Optimization Techniques Reference](./references/optimization_techniques.md) - Detailed technical reference
- Optimization Techniques Reference - Detailed technical reference
Related skills in this collection:
- context-fundamentals - Context basics

View File

@@ -297,7 +297,7 @@ Task Call:
1. Point one
2. Point two
3. Point three
- **Source**: [Link](URL)
- **Source**: Link
- **Keywords**: `keyword1` `keyword2` `keyword3`
- **Score**: ⭐⭐⭐⭐⭐ (5/5)

View File

@@ -52,11 +52,7 @@ oldWorkflows, _ := dbos.ListWorkflows(ctx,
```go
// Fork a workflow from a failed step to run on the new version
handle, _ := dbos.ForkWorkflow[string](ctx, dbos.ForkWorkflowInput{
OriginalWorkflowID: workflowID,
StartStep: failedStepID,
ApplicationVersion: "2.0.0",
})
handle, _ := dbos.ForkWorkflowstring
```
Reference: [Versioning](https://docs.dbos.dev/golang/tutorials/upgrading-workflows#versioning)

View File

@@ -40,8 +40,8 @@ func processData(ctx dbos.DBOSContext, input string) (string, error) {
}
// Read events from outside the workflow
status, err := dbos.GetEvent[string](ctx, workflowID, "status", 60*time.Second)
progress, err := dbos.GetEvent[int](ctx, workflowID, "progress", 60*time.Second)
status, err := dbos.GetEventstring
progress, err := dbos.GetEventint
```
Events are useful for interactive workflows. For example, a checkout workflow can publish a payment URL for the caller to redirect to:
@@ -61,7 +61,7 @@ func checkoutWorkflow(ctx dbos.DBOSContext, order Order) (string, error) {
// HTTP handler starts workflow and reads the payment URL
handle, _ := dbos.RunWorkflow(ctx, checkoutWorkflow, order)
url, _ := dbos.GetEvent[string](ctx, handle.GetWorkflowID(), "paymentURL", 300*time.Second)
url, _ := dbos.GetEventstring, "paymentURL", 300*time.Second)
```
`GetEvent` blocks until the event is set or the timeout expires. It returns the zero value of the type if the timeout is reached.

View File

@@ -21,7 +21,7 @@ ch := make(chan string) // Not durable!
```go
func checkoutWorkflow(ctx dbos.DBOSContext, orderID string) (string, error) {
// Wait for payment notification (timeout 120 seconds)
notification, err := dbos.Recv[string](ctx, "payment_status", 120*time.Second)
notification, err := dbos.Recvstring
if err != nil {
return "", err
}

View File

@@ -43,13 +43,13 @@ func processWorkflow(ctx dbos.DBOSContext, items []string) (string, error) {
// Read the stream synchronously (blocks until closed)
handle, _ := dbos.RunWorkflow(ctx, processWorkflow, items)
values, closed, err := dbos.ReadStream[string](ctx, handle.GetWorkflowID(), "results")
values, closed, err := dbos.ReadStreamstring, "results")
```
**Async stream reading with channels:**
```go
ch, err := dbos.ReadStreamAsync[string](ctx, handle.GetWorkflowID(), "results")
ch, err := dbos.ReadStreamAsyncstring, "results")
if err != nil {
log.Fatal(err)
}

View File

@@ -53,7 +53,7 @@ func main() {
Retrieve a handle later by workflow ID:
```go
handle, err := dbos.RetrieveWorkflow[string](ctx, workflowID)
handle, err := dbos.RetrieveWorkflowstring
result, err := handle.GetResult()
```

View File

@@ -53,7 +53,7 @@ func myWorkflow(ctx dbos.DBOSContext, input string) (string, error) {
return "", err
}
// Receive messages from the workflow
msg, err := dbos.Recv[string](ctx, "topic", 60*time.Second)
msg, err := dbos.Recvstring
// Set events from the workflow
dbos.SetEvent(ctx, "status", "done")
return data, nil

View File

@@ -24,7 +24,7 @@ handle, _ := dbos.RunWorkflow(ctx, processTask, "data")
err := dbos.CancelWorkflow(ctx, workflowID)
// Resume from the last completed step
handle, err := dbos.ResumeWorkflow[string](ctx, workflowID)
handle, err := dbos.ResumeWorkflowstring
result, err := handle.GetResult()
```
@@ -39,12 +39,7 @@ Fork a workflow from a specific step:
steps, err := dbos.GetWorkflowSteps(ctx, workflowID)
// Fork from a specific step
forkHandle, err := dbos.ForkWorkflow[string](ctx, dbos.ForkWorkflowInput{
OriginalWorkflowID: workflowID,
StartStep: 2, // Fork from step 2
ForkedWorkflowID: "new-wf-id", // Optional
ApplicationVersion: "2.0.0", // Optional
})
forkHandle, err := dbos.ForkWorkflowstring
result, err := forkHandle.GetResult()
```

View File

@@ -1031,7 +1031,7 @@ class ProductionDebugger {
['log', 'debug', 'info', 'warn', 'error'].forEach(method => {
console[method] = (...args) => {
req.debugContext.log(req.id, method, args[0], args.slice(1));
originalConsole[method](...args);
originalConsolemethod;
};
});

View File

@@ -359,7 +359,7 @@ pytest --cov=your_package
## License
This project is licensed under the ${LICENSE} License - see the [LICENSE](LICENSE) file for details.
This project is licensed under the ${LICENSE} License - see the LICENSE file for details.
```
### Example 5: Function Documentation Generator

View File

@@ -48,8 +48,8 @@ Brief one-line description.
## Documentation
- [API Reference](./docs/api.md)
- [Architecture](./docs/architecture.md)
- API Reference
- Architecture
## License

View File

@@ -216,7 +216,7 @@ This skill connects to all other skills as a cross-cutting concern:
## References
Internal reference:
- [Metrics Reference](./references/metrics.md) - Detailed evaluation metrics and implementation
- Metrics Reference - Detailed evaluation metrics and implementation
## References

View File

@@ -9,7 +9,7 @@ Create FastAPI routers following established patterns with proper authentication
## Quick Start
Copy the template from [assets/template.py](assets/template.py) and replace placeholders:
Copy the template from assets/template.py and replace placeholders:
- `{{ResourceName}}` → PascalCase name (e.g., `Project`)
- `{{resource_name}}` → snake_case name (e.g., `project`)
- `{{resource_plural}}` → plural form (e.g., `projects`)

View File

@@ -292,9 +292,9 @@ git branch -D upgrade/{package_name}-{target_version}
## Resources
- [Official Migration Guide]({get_official_guide_url(package_name, target_version)})
- [Changelog]({get_changelog_url(package_name, target_version)})
- [Community Discussions]({get_community_url(package_name)})
- Official Migration Guide})
- Changelog})
- Community Discussions})
"""
return guide

View File

@@ -583,6 +583,6 @@ export function PageTransition({ children }: PageTransitionProps) {
## Related Files
- [Design Tokens](./references/design-tokens.md) — Complete color system, spacing, typography scales
- [Components](./references/components.md) — Button, Card, Input, Dialog, Tabs, and more
- [Patterns](./references/patterns.md) — Page layouts, navigation, lists, forms
- Design Tokens — Complete color system, spacing, typography scales
- Components — Button, Card, Input, Dialog, Tabs, and more
- Patterns — Page layouts, navigation, lists, forms

View File

@@ -64,7 +64,7 @@ Transform messy input (error logs, voice notes, screenshots) into clean, actiona
- Medium: Feature impaired, workaround exists
- Low: Minor inconvenience, cosmetic
**Image/GIF handling**: Reference attachments inline. Format: `![Description](attachment-name.png)`
**Image/GIF handling**: Reference attachments inline. Format: `!Description`
## Examples

View File

@@ -194,5 +194,5 @@ hf cache rm model/gpt2 # Remove a repo from cache
## References
- **Complete command reference**: See [references/commands.md](references/commands.md)
- **Workflow examples**: See [references/examples.md](references/examples.md)
- **Complete command reference**: See references/commands.md
- **Workflow examples**: See references/examples.md

View File

@@ -360,7 +360,7 @@ Choose the right tool for the task:
}
```
> **WARNING**: Do NOT use deprecated community servers. See [troubleshooting.md](troubleshooting.md) for details.
> **WARNING**: Do NOT use deprecated community servers. See troubleshooting.md for details.
### MCP Reliability (Official Server)
@@ -383,7 +383,7 @@ node scripts/linear-helpers.mjs update-status Done 123 124 125
### Helper Script Reference
For detailed helper script usage, see **[troubleshooting.md](troubleshooting.md)**.
For detailed helper script usage, see **troubleshooting.md**.
### Parallel Agent Execution
@@ -409,7 +409,7 @@ Task({
- Quick status checks
- Operations needing immediate results
See **[sync.md](sync.md)** for parallel execution patterns.
See **sync.md** for parallel execution patterns.
## Critical Requirements
@@ -422,7 +422,7 @@ See **[sync.md](sync.md)** for parallel execution patterns.
| Issue | Project | Not visible in project board |
| Project | Initiative | Not visible in roadmap |
See **[projects.md](projects.md)** for complete project creation checklist.
See **projects.md** for complete project creation checklist.
---
@@ -435,7 +435,7 @@ See **[projects.md](projects.md)** for complete project creation checklist.
### Labels
Uses **domain-based label taxonomy**. See [docs/labels.md](docs/labels.md).
Uses **domain-based label taxonomy**. See docs/labels.md.
**Key rules:**
- ONE Type label: `feature`, `bug`, `refactor`, `chore`, `spike`
@@ -464,7 +464,7 @@ Scripts provide full type hints and are easier to debug than raw GraphQL for mul
**Fallback only.** Use when operations aren't supported by MCP or SDK.
See **[api.md](api.md)** for complete documentation including:
See **api.md** for complete documentation including:
- Authentication and setup
- Example queries and mutations
- Timeout handling patterns
@@ -479,7 +479,7 @@ npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"
## Projects & Initiatives
For advanced project and initiative management patterns, see **[projects.md](projects.md)**.
For advanced project and initiative management patterns, see **projects.md**.
**Quick reference** - common project commands:
@@ -515,7 +515,7 @@ Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
## Sync Patterns (Bulk Operations)
For bulk synchronization of code changes to Linear, see **[sync.md](sync.md)**.
For bulk synchronization of code changes to Linear, see **sync.md**.
**Quick sync commands:**
@@ -533,11 +533,11 @@ npx tsx scripts/linear-ops.ts project-status "My Project" completed
| Document | Purpose |
|----------|---------|
| [api.md](api.md) | GraphQL API reference, timeout handling |
| [sdk.md](sdk.md) | SDK automation patterns |
| [sync.md](sync.md) | Bulk sync patterns |
| [projects.md](projects.md) | Project & initiative management |
| [troubleshooting.md](troubleshooting.md) | Common issues, MCP debugging |
| [docs/labels.md](docs/labels.md) | Label taxonomy |
| api.md | GraphQL API reference, timeout handling |
| sdk.md | SDK automation patterns |
| sync.md | Bulk sync patterns |
| projects.md | Project & initiative management |
| troubleshooting.md | Common issues, MCP debugging |
| docs/labels.md | Label taxonomy |
**External:** [Linear MCP Documentation](https://linear.app/docs/mcp.md)

View File

@@ -474,7 +474,7 @@ class PromptChain:
# Parse output if needed
if step.get("parser"):
output = step["parser"](output)
output = step"parser"
context[step["output_key"]] = output
results.append({

View File

@@ -657,7 +657,7 @@ class FunctionCallingInterface:
)
# Execute function
result = await self.functions[function_name]['function'](**validated_args)
result = await self.functions[function_name]'function'
# Return result for LLM to process
return {

View File

@@ -276,7 +276,7 @@ await foreach (var activity in client.AskQuestionAsync("Hello!", null))
| File | Contents |
| --- | --- |
| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Import paths, hosting pipeline, Copilot Studio client patterns, anti-patterns |
| references/acceptance-criteria.md | Import paths, hosting pipeline, Copilot Studio client patterns, anti-patterns |
## Reference Links

View File

@@ -90,9 +90,7 @@ ADAPTER = CloudAdapter(connection_manager=CONNECTION_MANAGER)
AUTHORIZATION = Authorization(STORAGE, CONNECTION_MANAGER, **agents_sdk_config)
# Create AgentApplication
AGENT_APP = AgentApplication[TurnState](
storage=STORAGE, adapter=ADAPTER, authorization=AUTHORIZATION, **agents_sdk_config
)
AGENT_APP = AgentApplicationTurnState
@AGENT_APP.conversation_update("membersAdded")
@@ -136,9 +134,7 @@ from microsoft_agents.hosting.core import (
)
from microsoft_agents.activity import ActivityTypes
AGENT_APP = AgentApplication[TurnState](
storage=STORAGE, adapter=ADAPTER, authorization=AUTHORIZATION, **agents_sdk_config
)
AGENT_APP = AgentApplicationTurnState
# Welcome handler
@AGENT_APP.conversation_update("membersAdded")
@@ -333,7 +329,7 @@ asyncio.run(main())
| File | Contents |
| --- | --- |
| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Import paths, hosting pipeline, streaming, OAuth, and Copilot Studio patterns |
| references/acceptance-criteria.md | Import paths, hosting pipeline, streaming, OAuth, and Copilot Studio patterns |
## Reference Links

View File

@@ -168,7 +168,7 @@ window.WebChat.renderWebChat({
| File | Contents |
| --- | --- |
| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Import paths, hosting pipeline, streaming, and Copilot Studio patterns |
| references/acceptance-criteria.md | Import paths, hosting pipeline, streaming, and Copilot Studio patterns |
## Reference Links

View File

@@ -34,7 +34,7 @@ Before building a custom server, check if Microsoft already provides one:
| **Playwright MCP** | Local | Browser automation and testing |
| **GitHub MCP** | Remote | `https://api.githubcopilot.com/mcp` |
**Full ecosystem:** See [🔷 Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) for complete server catalog and patterns.
**Full ecosystem:** See 🔷 Microsoft MCP Patterns for complete server catalog and patterns.
### When to Use Microsoft vs Custom
@@ -44,7 +44,7 @@ Before building a custom server, check if Microsoft already provides one:
| AI Foundry agents/evals | Use **Foundry MCP** remote server |
| Custom internal APIs | Build **custom server** (this guide) |
| Third-party SaaS integration | Build **custom server** (this guide) |
| Extending Azure MCP | Follow [Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md)
| Extending Azure MCP | Follow Microsoft MCP Patterns
---
@@ -102,18 +102,18 @@ Key pages to review:
**Load framework documentation:**
- **MCP Best Practices**: [📋 View Best Practices](./reference/mcp_best_practices.md) - Core guidelines
- **MCP Best Practices**: 📋 View Best Practices - Core guidelines
**For TypeScript (recommended):**
- **TypeScript SDK**: Use WebFetch to load `https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md`
- [⚡ TypeScript Guide](./reference/node_mcp_server.md) - TypeScript patterns and examples
- ⚡ TypeScript Guide - TypeScript patterns and examples
**For Python:**
- **Python SDK**: Use WebFetch to load `https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md`
- [🐍 Python Guide](./reference/python_mcp_server.md) - Python patterns and examples
- 🐍 Python Guide - Python patterns and examples
**For C#/.NET (Microsoft ecosystem):**
- [🔷 Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) - C# patterns, Azure MCP architecture, command hierarchy
- 🔷 Microsoft MCP Patterns - C# patterns, Azure MCP architecture, command hierarchy
#### 1.4 Plan Your Implementation
@@ -130,9 +130,9 @@ Prioritize comprehensive API coverage. List endpoints to implement, starting wit
#### 2.1 Set Up Project Structure
See language-specific guides for project setup:
- [⚡ TypeScript Guide](./reference/node_mcp_server.md) - Project structure, package.json, tsconfig.json
- [🐍 Python Guide](./reference/python_mcp_server.md) - Module organization, dependencies
- [🔷 Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) - C# project structure, command hierarchy
- ⚡ TypeScript Guide - Project structure, package.json, tsconfig.json
- 🐍 Python Guide - Module organization, dependencies
- 🔷 Microsoft MCP Patterns - C# project structure, command hierarchy
#### 2.2 Implement Core Infrastructure
@@ -203,7 +203,7 @@ See language-specific guides for detailed testing approaches and quality checkli
After implementing your MCP server, create comprehensive evaluations to test its effectiveness.
**Load [✅ Evaluation Guide](./reference/evaluation.md) for complete evaluation guidelines.**
**Load ✅ Evaluation Guide for complete evaluation guidelines.**
#### 4.1 Understand Evaluation Purpose
@@ -252,7 +252,7 @@ Load these resources as needed during development:
### Core MCP Documentation (Load First)
- **MCP Protocol**: Start with sitemap at `https://modelcontextprotocol.io/sitemap.xml`, then fetch specific pages with `.md` suffix
- [📋 MCP Best Practices](./reference/mcp_best_practices.md) - Universal MCP guidelines including:
- 📋 MCP Best Practices - Universal MCP guidelines including:
- Server and tool naming conventions
- Response format guidelines (JSON vs Markdown)
- Pagination best practices
@@ -260,7 +260,7 @@ Load these resources as needed during development:
- Security and error handling standards
### Microsoft MCP Documentation (For Azure/Foundry)
- [🔷 Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) - Microsoft-specific patterns including:
- 🔷 Microsoft MCP Patterns - Microsoft-specific patterns including:
- Azure MCP Server architecture (48+ Azure services)
- C#/.NET command implementation patterns
- Remote MCP with Foundry Agent Service
@@ -270,24 +270,24 @@ Load these resources as needed during development:
### SDK Documentation (Load During Phase 1/2)
- **Python SDK**: Fetch from `https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md`
- **TypeScript SDK**: Fetch from `https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md`
- **Microsoft MCP SDK**: See [Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) for C#/.NET
- **Microsoft MCP SDK**: See Microsoft MCP Patterns for C#/.NET
### Language-Specific Implementation Guides (Load During Phase 2)
- [🐍 Python Implementation Guide](./reference/python_mcp_server.md) - Complete Python/FastMCP guide with:
- 🐍 Python Implementation Guide - Complete Python/FastMCP guide with:
- Server initialization patterns
- Pydantic model examples
- Tool registration with `@mcp.tool`
- Complete working examples
- Quality checklist
- [⚡ TypeScript Implementation Guide](./reference/node_mcp_server.md) - Complete TypeScript guide with:
- ⚡ TypeScript Implementation Guide - Complete TypeScript guide with:
- Project structure
- Zod schema patterns
- Tool registration with `server.registerTool`
- Complete working examples
- Quality checklist
- [🔷 Microsoft MCP Patterns](./reference/microsoft_mcp_patterns.md) - Complete C#/.NET guide with:
- 🔷 Microsoft MCP Patterns - Complete C#/.NET guide with:
- Command hierarchy (BaseCommand → GlobalCommand → SubscriptionCommand)
- Naming conventions (`{Resource}{Operation}Command`)
- Option handling with `.AsRequired()` / `.AsOptional()`
@@ -295,7 +295,7 @@ Load these resources as needed during development:
- Live test patterns with Bicep
### Evaluation Guide (Load During Phase 4)
- [✅ Evaluation Guide](./reference/evaluation.md) - Complete evaluation creation guide with:
- ✅ Evaluation Guide - Complete evaluation creation guide with:
- Question creation guidelines
- Answer verification strategies
- XML format specifications

View File

@@ -207,7 +207,7 @@ This skill builds on context-fundamentals. It connects to:
## References
Internal reference:
- [Implementation Reference](./references/implementation.md) - Detailed implementation patterns
- Implementation Reference - Detailed implementation patterns
Related skills in this collection:
- context-fundamentals - Context basics

View File

@@ -239,7 +239,7 @@ This skill builds on context-fundamentals and context-degradation. It connects t
## References
Internal reference:
- [Frameworks Reference](./references/frameworks.md) - Detailed framework implementation patterns
- Frameworks Reference - Detailed framework implementation patterns
Related skills in this collection:
- context-fundamentals - Context basics

View File

@@ -233,7 +233,7 @@ return [{
}]
```
**See**: [DATA_ACCESS.md](DATA_ACCESS.md) for comprehensive guide
**See**: DATA_ACCESS.md for comprehensive guide
---
@@ -257,7 +257,7 @@ name = webhook_data.get("name")
**Why**: Webhook node wraps all request data under `body` property. This includes POST data, query parameters, and JSON payloads.
**See**: [DATA_ACCESS.md](DATA_ACCESS.md) for full webhook structure details
**See**: DATA_ACCESS.md for full webhook structure details
---
@@ -320,7 +320,7 @@ return [{"data": value}] # Should be {"json": value}
**Why it matters**: Next nodes expect list format. Incorrect format causes workflow execution to fail.
**See**: [ERROR_PATTERNS.md](ERROR_PATTERNS.md) #2 for detailed error solutions
**See**: ERROR_PATTERNS.md #2 for detailed error solutions
---
@@ -370,7 +370,7 @@ import statistics # ✅ Statistical functions
- ✅ Use **HTTP Request node** + **HTML Extract node**
- ✅ Or switch to **JavaScript** with regex/string methods
**See**: [STANDARD_LIBRARY.md](STANDARD_LIBRARY.md) for complete reference
**See**: STANDARD_LIBRARY.md for complete reference
---
@@ -490,7 +490,7 @@ else:
return [{"json": {"error": "No values found"}}]
```
**See**: [COMMON_PATTERNS.md](COMMON_PATTERNS.md) for 10 detailed Python patterns
**See**: COMMON_PATTERNS.md for 10 detailed Python patterns
---
@@ -554,7 +554,7 @@ email = _json["body"]["email"]
email = _json.get("body", {}).get("email", "no-email")
```
**See**: [ERROR_PATTERNS.md](ERROR_PATTERNS.md) for comprehensive error guide
**See**: ERROR_PATTERNS.md for comprehensive error guide
---
@@ -598,7 +598,7 @@ from statistics import mean, median, stdev
average = mean([1, 2, 3, 4, 5])
```
**See**: [STANDARD_LIBRARY.md](STANDARD_LIBRARY.md) for complete reference
**See**: STANDARD_LIBRARY.md for complete reference
---
@@ -736,10 +736,10 @@ Before deploying Python Code nodes, verify:
## Additional Resources
### Related Files
- [DATA_ACCESS.md](DATA_ACCESS.md) - Comprehensive Python data access patterns
- [COMMON_PATTERNS.md](COMMON_PATTERNS.md) - 10 Python patterns for n8n
- [ERROR_PATTERNS.md](ERROR_PATTERNS.md) - Top 5 errors and solutions
- [STANDARD_LIBRARY.md](STANDARD_LIBRARY.md) - Complete standard library reference
- DATA_ACCESS.md - Comprehensive Python data access patterns
- COMMON_PATTERNS.md - 10 Python patterns for n8n
- ERROR_PATTERNS.md - Top 5 errors and solutions
- STANDARD_LIBRARY.md - Complete standard library reference
### n8n Documentation
- Code Node Guide: https://docs.n8n.io/code/code-node/

View File

@@ -25,9 +25,9 @@ Use this skill when:
n8n-mcp provides tools organized into categories:
1. **Node Discovery**[SEARCH_GUIDE.md](SEARCH_GUIDE.md)
2. **Configuration Validation**[VALIDATION_GUIDE.md](VALIDATION_GUIDE.md)
3. **Workflow Management**[WORKFLOW_GUIDE.md](WORKFLOW_GUIDE.md)
1. **Node Discovery** → SEARCH_GUIDE.md
2. **Configuration Validation** → VALIDATION_GUIDE.md
3. **Workflow Management** → WORKFLOW_GUIDE.md
4. **Template Library** - Search and deploy 2,700+ real workflows
5. **Documentation & Guides** - Tool docs, AI agent guide, Code node guides
@@ -375,13 +375,13 @@ await n8n_update_partial_workflow({
## Detailed Guides
### Node Discovery Tools
See [SEARCH_GUIDE.md](SEARCH_GUIDE.md) for:
See SEARCH_GUIDE.md for:
- search_nodes
- get_node with detail levels (minimal, standard, full)
- get_node modes (info, docs, search_properties, versions)
### Validation Tools
See [VALIDATION_GUIDE.md](VALIDATION_GUIDE.md) for:
See VALIDATION_GUIDE.md for:
- Validation profiles explained
- validate_node with modes (minimal, full)
- validate_workflow complete structure
@@ -389,7 +389,7 @@ See [VALIDATION_GUIDE.md](VALIDATION_GUIDE.md) for:
- Handling validation errors
### Workflow Management
See [WORKFLOW_GUIDE.md](WORKFLOW_GUIDE.md) for:
See WORKFLOW_GUIDE.md for:
- n8n_create_workflow
- n8n_update_partial_workflow (17 operation types!)
- Smart parameters (branch, case)
@@ -639,9 +639,9 @@ validate_node({nodeType: "nodes-base.webhook", config: {}, mode: "minimal"})
7. activateWorkflow → go live!
For details, see:
- [SEARCH_GUIDE.md](SEARCH_GUIDE.md) - Node discovery
- [VALIDATION_GUIDE.md](VALIDATION_GUIDE.md) - Configuration validation
- [WORKFLOW_GUIDE.md](WORKFLOW_GUIDE.md) - Workflow management
- SEARCH_GUIDE.md - Node discovery
- VALIDATION_GUIDE.md - Configuration validation
- WORKFLOW_GUIDE.md - Workflow management
---

View File

@@ -768,8 +768,8 @@ get_node({
For comprehensive guides on specific topics:
- **[DEPENDENCIES.md](DEPENDENCIES.md)** - Deep dive into property dependencies and displayOptions
- **[OPERATION_PATTERNS.md](OPERATION_PATTERNS.md)** - Common configuration patterns by node type
- **DEPENDENCIES.md** - Deep dive into property dependencies and displayOptions
- **OPERATION_PATTERNS.md** - Common configuration patterns by node type
---

View File

@@ -85,9 +85,9 @@ node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery
## References
- [references/message-debugging-reference.md](references/message-debugging-reference.md) - Message debugging guide
- [references/triage-reference.md](references/triage-reference.md) - Error triage guide
- [references/health-reference.md](references/health-reference.md) - Health check guide
- references/message-debugging-reference.md - Message debugging guide
- references/triage-reference.md - Error triage guide
- references/health-reference.md - Health check guide
## Related skills

View File

@@ -116,6 +116,6 @@ new Audio(audioUrl).play();
## References
- **Full architecture**: See [references/architecture.md](references/architecture.md) for complete stack design
- **Code examples**: See [references/code-examples.md](references/code-examples.md) for production patterns
- **PCM conversion**: Use [scripts/pcm_to_wav.py](scripts/pcm_to_wav.py) for audio format conversion
- **Full architecture**: See references/architecture.md for complete stack design
- **Code examples**: See references/code-examples.md for production patterns
- **PCM conversion**: Use scripts/pcm_to_wav.py for audio format conversion

View File

@@ -221,8 +221,8 @@ The deployment completed at 14:23, but the first alert didn't fire until 14:31 (
- 2023-11-02: Similar connection issue in User Service (POSTMORTEM-42)
### References
- [Connection Pool Best Practices](internal-wiki/connection-pools)
- [Deployment Runbook](internal-wiki/deployment-runbook)
- Connection Pool Best Practices
- Deployment Runbook
```
### Template 2: 5 Whys Analysis

View File

@@ -647,7 +647,7 @@ Then configure:
## 📖 Learn More
- **[Skill Development Guide](../../resources/skills-development.md)** - Learn how to create your own skills
- **Skill Development Guide** - Learn how to create your own skills
- **[SKILL.md](./SKILL.md)** - Full technical specification of this skill
- **[Repository README](../../README.md)** - Overview of all available skills

View File

@@ -9,7 +9,7 @@ Create Pydantic models following the multi-model pattern for clean API contracts
## Quick Start
Copy the template from [assets/template.py](assets/template.py) and replace placeholders:
Copy the template from assets/template.py and replace placeholders:
- `{{ResourceName}}` → PascalCase name (e.g., `Project`)
- `{{resource_name}}` → snake_case name (e.g., `project`)

View File

@@ -9,15 +9,15 @@ Create React Flow node components following established patterns with proper Typ
## Quick Start
Copy templates from [assets/](assets/) and replace placeholders:
Copy templates from assets/ and replace placeholders:
- `{{NodeName}}` → PascalCase component name (e.g., `VideoNode`)
- `{{nodeType}}` → kebab-case type identifier (e.g., `video-node`)
- `{{NodeData}}` → Data interface name (e.g., `VideoNodeData`)
## Templates
- [assets/template.tsx](assets/template.tsx) - Node component
- [assets/types.template.ts](assets/types.template.ts) - TypeScript definitions
- assets/template.tsx - Node component
- assets/types.template.ts - TypeScript definitions
## Node Component Pattern

View File

@@ -190,7 +190,7 @@ t5_ = Subreddit
**Text Formatting**:
- Reddit uses Markdown for post and comment formatting
- Code blocks, tables, and headers are supported
- Links use `[text](url)` format
- Links use `text` format
- Mention users with `u/username`, subreddits with `r/subreddit`
## Quick Reference

View File

@@ -17,7 +17,7 @@ Instead, drive all animations from `useCurrentFrame()`.
## Bar Chart Animations
See [Bar Chart Example](assets/charts/bar-chart.tsx) for a basic example implmentation.
See Bar Chart Example for a basic example implmentation.
### Staggered Bars

View File

@@ -85,15 +85,15 @@ codeql database create mydb --language=python
## Reference Documentation
- [Semgrep Rule Creation](references/semgrep-rules.md) - Pattern-based security rule development
- [SonarQube Configuration](references/sonarqube-config.md) - Quality gates and profiles
- [CodeQL Setup Guide](references/codeql-setup.md) - Query development and workflows
- Semgrep Rule Creation - Pattern-based security rule development
- SonarQube Configuration - Quality gates and profiles
- CodeQL Setup Guide - Query development and workflows
## Templates & Assets
- [semgrep-config.yml](assets/semgrep-config.yml) - Production-ready Semgrep configuration
- [sonarqube-settings.xml](assets/sonarqube-settings.xml) - SonarQube quality profile template
- [run-sast.sh](scripts/run-sast.sh) - Automated SAST execution script
- semgrep-config.yml - Production-ready Semgrep configuration
- sonarqube-settings.xml - SonarQube quality profile template
- run-sast.sh - Automated SAST execution script
## Integration Patterns
@@ -190,9 +190,9 @@ semgrep --config p/pci-dss --json -o pci-scan-results.json
## Related Skills
- [OWASP Top 10 Checklist](../owasp-top10-checklist/SKILL.md)
- [Container Security](../container-security/SKILL.md)
- [Dependency Scanning](../dependency-scanning/SKILL.md)
- OWASP Top 10 Checklist
- Container Security
- Dependency Scanning
## Tool Comparison

View File

@@ -225,8 +225,8 @@ client.delete_item(item_id)
| File | Contents |
|------|----------|
| [references/tools.md](references/tools.md) | Tool integrations |
| [references/streaming.md](references/streaming.md) | Event streaming patterns |
| references/tools.md | Tool integrations |
| references/streaming.md | Event streaming patterns |
```
---
@@ -525,8 +525,8 @@ After creating the skill:
[Minimal example]
## Advanced Features
- **Streaming**: See [references/streaming.md](references/streaming.md)
- **Tools**: See [references/tools.md](references/tools.md)
- **Streaming**: See references/streaming.md
- **Tools**: See references/tools.md
```
### Pattern 2: Language Variants

View File

@@ -266,7 +266,7 @@ obsidian_get_recent_periodic_notes --period daily --limit 2 | \
• Need staging database access for migration testing - @infra-team
## 📎 Links
[PR #789](link) | [JIRA Sprint Board](link)
• PR #789 | JIRA Sprint Board
```
**Thread-Based Standup:**
@@ -351,7 +351,7 @@ From standup notes, automatically extract:
• Taking tomorrow afternoon off (dentist appointment) - Will post morning standup but limited availability after 12pm
• Mobile responsiveness research doc started: [Link to Notion doc]
📎 [Sprint Board](link) | [My Active PRs](link)
📎 Sprint Board | My Active PRs
```
### Example 2: AI-Generated Standup from Git History
@@ -527,7 +527,7 @@ jira issues list --assignee currentUser() --status "In Progress"
• Heads up: Deploying migration to staging at noon, expect ~10min downtime
**🔗 Links**
[Active PRs](link) | [Sprint Board](link) | [Migration Runbook](link)
• Active PRs | Sprint Board | Migration Runbook
---
👀 = I've read this | 🤝 = I can help with something | 💬 = Reply in thread

View File

@@ -64,7 +64,7 @@ examples/ # Module usage examples (also serve as tests)
- Use **examples/** as both documentation and integration test fixtures
- Keep modules small and focused (single responsibility)
**For detailed module architecture, see:** [Code Patterns: Module Types & Hierarchy](references/code-patterns.md)
**For detailed module architecture, see:** Code Patterns: Module Types & Hierarchy
### 2. Naming Conventions
@@ -168,8 +168,8 @@ var.database_instance_class # Not just "instance_class"
- IAM policy statements: **set** (use for expressions)
**For detailed testing guides, see:**
- **[Testing Frameworks Guide](references/testing-frameworks.md)** - Deep dive into static analysis, native tests, and Terratest
- **[Quick Reference](references/quick-reference.md#testing-approach-selection)** - Decision flowchart and command cheat sheet
- **Testing Frameworks Guide** - Deep dive into static analysis, native tests, and Terratest
- **Quick Reference** - Decision flowchart and command cheat sheet
## Code Structure Standards
@@ -225,7 +225,7 @@ variable "environment" {
}
```
**For complete structure guidelines, see:** [Code Patterns: Block Ordering & Structure](references/code-patterns.md#block-ordering--structure)
**For complete structure guidelines, see:** Code Patterns: Block Ordering & Structure
## Count vs For_Each: When to Use Each
@@ -269,7 +269,7 @@ resource "aws_subnet" "private" {
}
```
**For migration guides and detailed examples, see:** [Code Patterns: Count vs For_Each](references/code-patterns.md#count-vs-for_each-deep-dive)
**For migration guides and detailed examples, see:** Code Patterns: Count vs For_Each
## Locals for Dependency Management
@@ -311,7 +311,7 @@ resource "aws_subnet" "public" {
- Ensures correct dependency order without explicit `depends_on`
- Particularly useful for VPC configurations with secondary CIDR blocks
**For detailed examples, see:** [Code Patterns: Locals for Dependency Management](references/code-patterns.md#locals-for-dependency-management)
**For detailed examples, see:** Code Patterns: Locals for Dependency Management
## Module Development
@@ -347,8 +347,8 @@ my-module/
- ✅ Document what consumers should do with each output
**For detailed module patterns, see:**
- **[Module Patterns Guide](references/module-patterns.md)** - Variable best practices, output design, ✅ DO vs ❌ DON'T patterns
- **[Quick Reference](references/quick-reference.md#common-patterns)** - Resource naming, variable naming, file organization
- **Module Patterns Guide** - Variable best practices, output design, ✅ DO vs ❌ DON'T patterns
- **Quick Reference** - Resource naming, variable naming, file organization
## CI/CD Integration
@@ -367,8 +367,8 @@ my-module/
4. **Tag all test resources** (track spending)
**For complete CI/CD templates, see:**
- **[CI/CD Workflows Guide](references/ci-cd-workflows.md)** - GitHub Actions, GitLab CI, Atlantis integration, cost optimization
- **[Quick Reference](references/quick-reference.md#troubleshooting-guide)** - Common CI/CD issues and solutions
- **CI/CD Workflows Guide** - GitHub Actions, GitLab CI, Atlantis integration, cost optimization
- **Quick Reference** - Common CI/CD issues and solutions
## Security & Compliance
@@ -395,7 +395,7 @@ checkov -d .
- Use least-privilege security groups
**For detailed security guidance, see:**
- **[Security & Compliance Guide](references/security-compliance.md)** - Trivy/Checkov integration, secrets management, state file security, compliance testing
- **Security & Compliance Guide** - Trivy/Checkov integration, secrets management, state file security, compliance testing
## Version Management
@@ -429,7 +429,7 @@ terraform init -upgrade # Updates providers
terraform plan
```
**For detailed version management, see:** [Code Patterns: Version Management](references/code-patterns.md#version-management)
**For detailed version management, see:** Code Patterns: Version Management
## Modern Terraform Features (1.0+)
@@ -474,7 +474,7 @@ variable "backup_days" {
}
```
**For complete patterns and examples, see:** [Code Patterns: Modern Terraform Features](references/code-patterns.md#modern-terraform-features-10)
**For complete patterns and examples, see:** Code Patterns: Modern Terraform Features
## Version-Specific Guidance
@@ -495,18 +495,18 @@ variable "backup_days" {
### Terraform vs OpenTofu
Both are fully supported by this skill. For licensing, governance, and feature comparison, see [Quick Reference: Terraform vs OpenTofu](references/quick-reference.md#terraform-vs-opentofu-comparison).
Both are fully supported by this skill. For licensing, governance, and feature comparison, see Quick Reference: Terraform vs OpenTofu.
## Detailed Guides
This skill uses **progressive disclosure** - essential information is in this main file, detailed guides are available when needed:
📚 **Reference Files:**
- **[Testing Frameworks](references/testing-frameworks.md)** - In-depth guide to static analysis, native tests, and Terratest
- **[Module Patterns](references/module-patterns.md)** - Module structure, variable/output best practices, ✅ DO vs ❌ DON'T patterns
- **[CI/CD Workflows](references/ci-cd-workflows.md)** - GitHub Actions, GitLab CI templates, cost optimization, automated cleanup
- **[Security & Compliance](references/security-compliance.md)** - Trivy/Checkov integration, secrets management, compliance testing
- **[Quick Reference](references/quick-reference.md)** - Command cheat sheets, decision flowcharts, troubleshooting guide
- **Testing Frameworks** - In-depth guide to static analysis, native tests, and Terratest
- **Module Patterns** - Module structure, variable/output best practices, ✅ DO vs ❌ DON'T patterns
- **CI/CD Workflows** - GitHub Actions, GitLab CI templates, cost optimization, automated cleanup
- **Security & Compliance** - Trivy/Checkov integration, secrets management, compliance testing
- **Quick Reference** - Command cheat sheets, decision flowcharts, troubleshooting guide
**How to use:** When you need detailed information on a topic, reference the appropriate guide. Claude will load it on demand to provide comprehensive guidance.

View File

@@ -98,7 +98,7 @@ The question to ask: are your tools enabling new capabilities, or are they const
**Build for Future Models**
Models improve faster than tooling can keep up. An architecture optimized for today's model may be over-constrained for tomorrow's. Build minimal architectures that can benefit from model improvements rather than sophisticated architectures that lock in current limitations.
See [Architectural Reduction Case Study](./references/architectural_reduction.md) for production evidence.
See Architectural Reduction Case Study for production evidence.
### Tool Description Engineering
@@ -295,8 +295,8 @@ This skill connects to:
## References
Internal references:
- [Best Practices Reference](./references/best_practices.md) - Detailed tool design guidelines
- [Architectural Reduction Case Study](./references/architectural_reduction.md) - Production evidence for tool minimalism
- Best Practices Reference - Detailed tool design guidelines
- Architectural Reduction Case Study - Production evidence for tool minimalism
Related skills in this collection:
- context-fundamentals - Tool context interactions

View File

@@ -315,20 +315,20 @@ Example:
| Track ID | Type | Status | Phase | Started | Assignee |
| ------------------------------------------------ | ------- | ----------- | ----- | ---------- | ---------- |
| [user-auth_20250115](tracks/user-auth_20250115/) | feature | in-progress | 2/3 | 2025-01-15 | @developer |
| [fix-login_20250114](tracks/fix-login_20250114/) | bug | pending | 0/2 | 2025-01-14 | - |
| user-auth_20250115 | feature | in-progress | 2/3 | 2025-01-15 | @developer |
| fix-login_20250114 | bug | pending | 0/2 | 2025-01-14 | - |
## Completed Tracks
| Track ID | Type | Completed | Duration |
| ---------------------------------------------- | ----- | ---------- | -------- |
| [setup-ci_20250110](tracks/setup-ci_20250110/) | chore | 2025-01-12 | 2 days |
| setup-ci_20250110 | chore | 2025-01-12 | 2 days |
## Archived Tracks
| Track ID | Reason | Archived |
| ---------------------------------------------------- | ---------- | ---------- |
| [old-feature_20241201](tracks/old-feature_20241201/) | Superseded | 2025-01-05 |
| old-feature_20241201 | Superseded | 2025-01-05 |
```
## Metadata (metadata.json) Fields

View File

@@ -106,7 +106,7 @@ Before deploying any skill:
## 🔗 Related Skills
- **[opencode-expert](skill://opencode-expert)**: For OpenCode environment configuration
- **opencode-expert**: For OpenCode environment configuration
- Use `/write-skill` command for guided skill creation
## Examples

View File

@@ -287,8 +287,8 @@ with pdfplumber.open("file.pdf") as pdf:
## Advanced features
**Form filling**: See [FORMS.md](FORMS.md) for complete guide
**API reference**: See [REFERENCE.md](REFERENCE.md) for all methods
**Form filling**: See FORMS.md for complete guide
**API reference**: See REFERENCE.md for all methods
**Examples**: See [EXAMPLES.md](EXAMPLES.md) for common patterns
````
@@ -313,10 +313,10 @@ bigquery-skill/
## Available datasets
**Finance**: Revenue, ARR, billing → See [reference/finance.md](reference/finance.md)
**Sales**: Opportunities, pipeline, accounts → See [reference/sales.md](reference/sales.md)
**Product**: API usage, features, adoption → See [reference/product.md](reference/product.md)
**Marketing**: Campaigns, attribution, email → See [reference/marketing.md](reference/marketing.md)
**Finance**: Revenue, ARR, billing → See reference/finance.md
**Sales**: Opportunities, pipeline, accounts → See reference/sales.md
**Product**: API usage, features, adoption → See reference/product.md
**Marketing**: Campaigns, attribution, email → See reference/marketing.md
## Quick search
@@ -338,14 +338,14 @@ Show basic content, link to advanced content:
## Creating documents
Use docx-js for new documents. See [DOCX-JS.md](DOCX-JS.md).
Use docx-js for new documents. See DOCX-JS.md.
## Editing documents
For simple edits, modify the XML directly.
**For tracked changes**: See [REDLINING.md](REDLINING.md)
**For OOXML details**: See [OOXML.md](OOXML.md)
**For tracked changes**: See REDLINING.md
**For OOXML details**: See OOXML.md
```
Claude reads REDLINING.md or OOXML.md only when the user needs those features.
@@ -360,10 +360,10 @@ Claude may partially read files when they're referenced from other referenced fi
```markdown theme={null}
# SKILL.md
See [advanced.md](advanced.md)...
See advanced.md...
# advanced.md
See [details.md](details.md)...
See details.md...
# details.md
Here's the actual information...
@@ -375,8 +375,8 @@ Here's the actual information...
# SKILL.md
**Basic usage**: [instructions in SKILL.md]
**Advanced features**: See [advanced.md](advanced.md)
**API reference**: See [reference.md](reference.md)
**Advanced features**: See advanced.md
**API reference**: See reference.md
**Examples**: See [examples.md](examples.md)
```

View File

@@ -111,7 +111,7 @@ another example
## Detailed Docs
For more options, run `--help` or see:
- [patterns.md](patterns.md)
- patterns.md
- [examples.md](examples.md)
```

View File

@@ -172,7 +172,7 @@ See [my-skill] for details.
See /home/user/.config/opencode/skills/my-skill/SKILL.md
# ✅ GOOD: Skill protocol
See [my-skill](skill://my-skill)
See my-skill
```
## Tier Selection

View File

@@ -127,8 +127,8 @@ Reference from SKILL.md:
```markdown
## Detailed Reference
- [Patterns](patterns.md) - Common usage patterns
- [Examples](examples.md) - Code samples
- Patterns - Common usage patterns
- Examples - Code samples
```
## Skill Types

View File

@@ -31,5 +31,5 @@ another example
## Detailed Docs
For more options, run `--help` or see:
- [patterns.md](patterns.md)
- [examples.md](examples.md)
- patterns.md
- examples.md

View File

@@ -349,7 +349,7 @@ Found a bug or have a feature request? Contributions welcome!
## License
MIT License - see [LICENSE](../../../LICENSE) for details.
MIT License - see LICENSE for details.
---

View File

@@ -9,7 +9,7 @@ Create Zustand stores following established patterns with proper TypeScript type
## Quick Start
Copy the template from [assets/template.ts](assets/template.ts) and replace placeholders:
Copy the template from assets/template.ts and replace placeholders:
- `{{StoreName}}` → PascalCase store name (e.g., `Project`)
- `{{description}}` → Brief description for JSDoc

File diff suppressed because it is too large Load Diff