diff --git a/plugins/phoenix/skills/phoenix-tracing/SKILL.md b/plugins/phoenix/skills/phoenix-tracing/SKILL.md index 8330ef3b9..4320577c2 100644 --- a/plugins/phoenix/skills/phoenix-tracing/SKILL.md +++ b/plugins/phoenix/skills/phoenix-tracing/SKILL.md @@ -85,10 +85,6 @@ Reference these guidelines when: - [fundamentals-required-attributes](references/fundamentals-required-attributes.md) - Required fields per span type - [fundamentals-universal-attributes](references/fundamentals-universal-attributes.md) - Common attributes (user.id, session.id) - [fundamentals-flattening](references/fundamentals-flattening.md) - JSON flattening rules -- [attributes-messages](references/attributes-messages.md) - Chat message format -- [attributes-metadata](references/attributes-metadata.md) - Custom metadata schema -- [attributes-graph](references/attributes-graph.md) - Agent workflow attributes -- [attributes-exceptions](references/attributes-exceptions.md) - Error tracking ## Common Workflows @@ -109,7 +105,6 @@ references/span-* # Span type specifications references/sessions-* # Session tracking references/production-* # Production deployment references/fundamentals-* # Core concepts -references/attributes-* # Attribute specifications # By language references/*-python.md # Python implementations diff --git a/skillcheck.toml b/skillcheck.toml new file mode 100644 index 000000000..61dd5057a --- /dev/null +++ b/skillcheck.toml @@ -0,0 +1,34 @@ +# skillcheck configuration for the awesome-copilot skill collection. +# https://github.com/moonrunnerkc/skillcheck +# +# Why `references.broken-link` is ignored +# --------------------------------------- +# Our SKILL.md files routinely document paths that are NOT files bundled next +# to the skill, and that a static reference checker cannot tell apart from a +# real broken link: +# * target-repo conventions the skill operates on, e.g. +# .github/copilot-instructions.md, .github/instructions/*.instructions.md +# * files the skill GENERATES at run time, e.g. +# reports/index.html, ./run/data/report-data.json +# * illustrative example paths, e.g. +# infrastructure/bicep/modules/app-service.bicep, docs/sprint-N/plan.md +# These are legitimate documentation, so we silence the broken-link rule rather +# than mangle the prose. The upstream over-flagging of npm specifiers, MIME +# types, CIDR suffixes, globs, and absolute/home paths is fixed in the checker +# itself (rules/references.py::_is_probable_file_ref), so this only covers the +# irreducibly ambiguous, extension-bearing relative paths above. +# +# `references.escape` is deliberately LEFT ON: it is a security check +# (path traversal / symlink escape, CWE-59) and produces no false positives +# against this collection. +ignore = ["references.broken-link"] + +# Why dirname checking is skipped +# ------------------------------- +# The source of truth lives under skills/ where related skills are organised +# into nested folders (e.g. skills/qdrant-monitoring/debugging/SKILL.md), while +# each skill's `name` is the flattened, canonical identifier it ships under +# after CI materialises it (qdrant-monitoring-debugging). The directory name +# therefore equals `name` only in the materialised plugins/*/skills/ tree, not +# in the nested source tree, so the dirname check does not apply pre-build. +skip-dirname-check = true diff --git a/skills/mvvm-toolkit-messenger/SKILL.md b/skills/mvvm-toolkit-messenger/SKILL.md index d9ab5e85d..a5f284f88 100644 --- a/skills/mvvm-toolkit-messenger/SKILL.md +++ b/skills/mvvm-toolkit-messenger/SKILL.md @@ -1,6 +1,6 @@ --- name: mvvm-toolkit-messenger -description: 'CommunityToolkit.Mvvm Messenger pub/sub for decoupled communication between ViewModels (or any objects). Covers WeakReferenceMessenger vs StrongReferenceMessenger, IRecipient, RequestMessage / AsyncRequestMessage / CollectionRequestMessage, ValueChangedMessage, channels (tokens), and the ObservableRecipient activation lifecycle. Use across WPF, WinUI 3, .NET MAUI, Uno, and Avalonia.' +description: 'CommunityToolkit.Mvvm Messenger pub/sub for decoupled communication between ViewModels (or any objects). Covers WeakReferenceMessenger vs StrongReferenceMessenger, IRecipient, RequestMessage / AsyncRequestMessage / CollectionRequestMessage, ValueChangedMessage, channels (tokens), and the ObservableRecipient activation lifecycle. Use across WPF, WinUI 3, .NET MAUI, Uno, and Avalonia.' --- # CommunityToolkit.Mvvm Messenger diff --git a/skills/phoenix-tracing/SKILL.md b/skills/phoenix-tracing/SKILL.md index 8330ef3b9..4320577c2 100644 --- a/skills/phoenix-tracing/SKILL.md +++ b/skills/phoenix-tracing/SKILL.md @@ -85,10 +85,6 @@ Reference these guidelines when: - [fundamentals-required-attributes](references/fundamentals-required-attributes.md) - Required fields per span type - [fundamentals-universal-attributes](references/fundamentals-universal-attributes.md) - Common attributes (user.id, session.id) - [fundamentals-flattening](references/fundamentals-flattening.md) - JSON flattening rules -- [attributes-messages](references/attributes-messages.md) - Chat message format -- [attributes-metadata](references/attributes-metadata.md) - Custom metadata schema -- [attributes-graph](references/attributes-graph.md) - Agent workflow attributes -- [attributes-exceptions](references/attributes-exceptions.md) - Error tracking ## Common Workflows @@ -109,7 +105,6 @@ references/span-* # Span type specifications references/sessions-* # Session tracking references/production-* # Production deployment references/fundamentals-* # Core concepts -references/attributes-* # Attribute specifications # By language references/*-python.md # Python implementations diff --git a/skills/qdrant-scaling/minimize-latency/SKILL.md b/skills/qdrant-scaling/minimize-latency/SKILL.md index 727d841cf..fcf18a071 100644 --- a/skills/qdrant-scaling/minimize-latency/SKILL.md +++ b/skills/qdrant-scaling/minimize-latency/SKILL.md @@ -29,7 +29,7 @@ RAM is the most critical resource for latency. If working set exceeds available ## Vertical Scaling for Latency -More RAM and faster CPU directly reduce latency. See [Vertical Scaling](../scaling-data-volume/vertical-scaling/SKILL.md) for node sizing guidelines. +More RAM and faster CPU directly reduce latency. See the **Vertical Scaling** skill (`qdrant-vertical-scaling`) for node sizing guidelines. ## What NOT to Do diff --git a/skills/qdrant-scaling/scaling-data-volume/vertical-scaling/SKILL.md b/skills/qdrant-scaling/scaling-data-volume/vertical-scaling/SKILL.md index a2cb1e84e..452373bc8 100644 --- a/skills/qdrant-scaling/scaling-data-volume/vertical-scaling/SKILL.md +++ b/skills/qdrant-scaling/scaling-data-volume/vertical-scaling/SKILL.md @@ -43,7 +43,7 @@ RAM is the most critical resource for Qdrant performance. Use these guidelines t - With binary quantization: divide by 32 [Binary quantization](https://search.qdrant.tech/md/documentation/manage-data/quantization/?s=binary-quantization) - Add overhead for HNSW index (~20-30% of vector data), payload indexes, and WAL - Reserve 20% headroom for optimizer operations and OS cache -- Monitor actual usage via Grafana/Prometheus before and after resizing [Monitoring](../../../qdrant-monitoring/SKILL.md) +- Monitor actual usage via Grafana/Prometheus before and after resizing (see the **Monitoring** skill, `qdrant-monitoring`) ## When Vertical Scaling Is No Longer Enough @@ -57,7 +57,7 @@ Recognize these signals that it's time to go horizontal: - Single-node CPU is maxed and query latency is unacceptable - Next vertical scaling step is the largest available node size. You might need to be able to temporarily scale up to the larger node size to do batch operations or recovery. If you are already at the largest node size, you won't be able to do that. -When you hit these limits, see [Horizontal Scaling](../horizontal-scaling/SKILL.md) for guidance on sharding and node planning. +When you hit these limits, see the **Horizontal Scaling** skill (`qdrant-horizontal-scaling`) for guidance on sharding and node planning. ## What NOT to Do diff --git a/skills/qdrant-scaling/scaling-qps/SKILL.md b/skills/qdrant-scaling/scaling-qps/SKILL.md index 765f2dee2..a2d6fb2a3 100644 --- a/skills/qdrant-scaling/scaling-qps/SKILL.md +++ b/skills/qdrant-scaling/scaling-qps/SKILL.md @@ -33,7 +33,7 @@ If a single node is saturated on CPU after applying the tuning above, scale hori - Each replica adds independent query capacity without re-sharding - Use `replication_factor: 2+` and route reads to replicas [Distributed deployment](https://search.qdrant.tech/md/documentation/operations/distributed_deployment/?s=replication) -See also [Horizontal Scaling](../scaling-data-volume/horizontal-scaling/SKILL.md) for general horizontal scaling guidance. +See also the **Horizontal Scaling** skill (`qdrant-horizontal-scaling`) for general horizontal scaling guidance. ## Disk I/O Bottlenecks