[doc] refactor: co-locate technique skills with machine-readable cards

Move perf-technique skills from flat .md files to subfolders with
SKILL.md + card.yaml, consolidating knowledge/techniques/ YAML cards
alongside their skills. Add resiliency skill and card. Refactor
docs/training/resiliency.md to be concise conceptual docs, offloading
operational details to skills/resiliency/SKILL.md.

Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>
Made-with: Cursor

Author: yaoyu-33

docs/training/hybrid-context-parallel.md

@@ -60,5 +60,5 @@ all Bridge initialization modes.
 
 - `docs/performance-guide.md`
 - `docs/training/communication-overlap.md`
-- `skills/perf-techniques/hybrid-context-parallel.md`
-- `knowledge/techniques/hybrid_context_parallel.yaml`
+- `skills/perf-techniques/hybrid-context-parallel/SKILL.md`
+- `skills/perf-techniques/hybrid-context-parallel/card.yaml`

docs/training/megatron-fsdp.md

@@ -98,4 +98,4 @@ The stable recommendation today is:
 - `docs/training/cpu-offloading.md`
 - `docs/performance-guide.md`
 - `skills/perf-techniques/megatron-fsdp.md`
-- `knowledge/techniques/megatron_fsdp.yaml`
+- `skills/perf-techniques/megatron-fsdp/card.yaml`

docs/training/packed-sequences.md

@@ -86,4 +86,4 @@ The most stable caveats to remember are:
 - `docs/performance-guide.md`
 - `docs/training/hybrid-context-parallel.md`
 - `skills/perf-techniques/sequence-packing.md`
-- `knowledge/techniques/packed_sequences_long_context.yaml`
+- `skills/perf-techniques/sequence-packing/card.yaml`

docs/training/resiliency.md

@@ -1,12 +1,11 @@
-# Technique Knowledge Cards
+# Technique Knowledge Cards — Moved
 
-This directory stores structured, machine-readable technique cards.
+Technique cards have been co-located with their operational skills under
+`skills/perf-techniques/<technique>/card.yaml`.
 
-Use this split:
+Each technique folder contains:
 
-- `docs/training/*.md` for stable human-facing guidance such as what a
-  technique is, when to use it, and durable conclusions.
-- `knowledge/techniques/*.yaml` for compact structured metadata, validation
-  status, constraints, and evidence pointers.
-- `skills/perf-techniques/*.md` for operational guidance such as enablement,
-  code anchors, pitfalls, and verification commands.
+- `SKILL.md` — operational guide (enablement, code anchors, pitfalls, verification)
+- `card.yaml` — structured metadata (validation status, constraints, evidence)
+
+Stable human-facing docs remain in `docs/training/*.md`.

knowledge/techniques/README.md

@@ -3,11 +3,11 @@
 This directory stores operational guides for performance and parallelism
 techniques.
 
-Use this split:
-
-- `docs/training/*.md` for stable, human-facing guidance such as what a
-  technique is, when to use it, and durable conclusions.
-- `knowledge/techniques/*.yaml` for structured machine-readable technique cards.
-- `skills/perf-techniques/*.md` for code-near operational guidance such as how
-  to enable a technique, important pitfalls, source-code anchors, and
-  verification commands.
+Each technique lives in its own subfolder with two files:
+
+- `SKILL.md` — operational guide (enablement, code anchors, pitfalls,
+  verification)
+- `card.yaml` — machine-readable structured metadata (validation status,
+  constraints, evidence)
+
+Stable human-facing docs live in `docs/training/*.md`.

skills/perf-techniques/README.md

@@ -8,7 +8,7 @@ description: Operational guide for enabling hierarchical context parallelism in
 For stable background and recommendation level, see:
 
 - `docs/training/hybrid-context-parallel.md`
-- `knowledge/techniques/hybrid_context_parallel.yaml`
+- `card.yaml` (co-located)
 
 ## Enablement