docs: use <repo>/<rel path> links throughout, document the convention
All cross-skill links now spell out the repository: skills-public/foo.md, skills-private/bar.md. These resolve from the shared parent directory, so one spelling works from either repo and from code-languages/ subdirectories — replacing the previous mix of ./, ../ and absolute file:// URLs. Link labels normalised to match. Convention added to the README conventions list. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
72834167b6
commit
58525056a1
10 files changed
+55
-48
No files matched your search
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# Bash / Shell — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds shell specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds shell specifics.
|
||||
|
||||
Bash is for **orchestration** — sequencing tools, wiring a build pipeline, gluing CLIs.
|
||||
Once a script grows real data structures, arithmetic, or parsing, it wants to be Python or
|
||||
@@ -164,12 +164,12 @@ mistakes before a human does.
|
||||
Standalone utility scripts belong in a **dedicated, version-controlled scripts directory**,
|
||||
symlinked into `PATH` rather than copied there. Never write a loose script directly into
|
||||
`~/.local/bin` or another `PATH` directory — the source of truth should be one versioned
|
||||
location. See [`../cli-tooling.md` §5](../cli-tooling.md) for the reasoning and the pattern.
|
||||
location. See [`cli-tooling.md` §5](skills-public/cli-tooling.md) for the reasoning and the pattern.
|
||||
|
||||
---
|
||||
|
||||
## 10. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`../cli-tooling.md`](../cli-tooling.md) — invoking other tools *from* these scripts:
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`cli-tooling.md`](skills-public/cli-tooling.md) — invoking other tools *from* these scripts:
|
||||
discovery, non-interactive flags, structured output.
|
||||
- [`python.md`](./python.md) — where a shell script should have become a Python script.
|
||||
- [`python.md`](skills-public/code-languages/python.md) — where a shell script should have become a Python script.
|
||||
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# C / C++ — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds C/C++ specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds C/C++ specifics.
|
||||
|
||||
C and C++ are for the cases with no better option: existing codebases, hard real-time paths,
|
||||
and FFI boundaries. **For new standalone work, prefer Rust** — the memory-safety guarantees
|
||||
@@ -148,6 +148,6 @@ When exposing C/C++ to another language:
|
||||
---
|
||||
|
||||
## 9. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`rust.md`](./rust.md) — the preferred language for new native work, and the usual consumer
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`rust.md`](skills-public/code-languages/rust.md) — the preferred language for new native work, and the usual consumer
|
||||
of these FFI boundaries.
|
||||
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# C# / .NET — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds .NET specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds .NET specifics.
|
||||
|
||||
---
|
||||
|
||||
@@ -150,5 +150,5 @@ interface, a type being renamed):
|
||||
---
|
||||
|
||||
## 9. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](./bash.md) — for the release pipeline scripts around a .NET build.
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](skills-public/code-languages/bash.md) — for the release pipeline scripts around a .NET build.
|
||||
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# Go — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds Go specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds Go specifics.
|
||||
|
||||
---
|
||||
|
||||
@@ -153,5 +153,5 @@ CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/app ./cmd/app
|
||||
---
|
||||
|
||||
## 10. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`js-typescript.md`](./js-typescript.md) — for the embedded frontend in a Go service.
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`js-typescript.md`](skills-public/code-languages/js-typescript.md) — for the embedded frontend in a Go service.
|
||||
@@ -9,7 +9,7 @@ description: >-
|
||||
|
||||
# TypeScript / JavaScript — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds JS/TS specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds JS/TS specifics.
|
||||
|
||||
---
|
||||
|
||||
@@ -199,5 +199,5 @@ Attach an `AbortController` to every long-lived `fetch` and abort it in cleanup.
|
||||
---
|
||||
|
||||
## 12. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](./bash.md) — for the build/release scripts around these projects.
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](skills-public/code-languages/bash.md) — for the build/release scripts around these projects.
|
||||
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# Python — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds Python specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds Python specifics.
|
||||
|
||||
---
|
||||
|
||||
@@ -149,5 +149,5 @@ When talking to a rate-limited API (a chat platform, a store, a tracker):
|
||||
---
|
||||
|
||||
## 10. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](./bash.md) — for the surrounding build and deploy scripts.
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`bash.md`](skills-public/code-languages/bash.md) — for the surrounding build and deploy scripts.
|
||||
@@ -8,7 +8,7 @@ description: >-
|
||||
|
||||
# Rust — Rules & Preferences
|
||||
|
||||
Extends [`../coding-dev.md`](../coding-dev.md). Everything there applies; this adds Rust specifics.
|
||||
Extends [`coding-dev.md`](skills-public/coding-dev.md). Everything there applies; this adds Rust specifics.
|
||||
|
||||
---
|
||||
|
||||
@@ -193,5 +193,5 @@ dependencies builds and tests directly on the host, which is seconds instead of
|
||||
---
|
||||
|
||||
## 11. Related
|
||||
- [`../coding-dev.md`](../coding-dev.md) — the general rules this extends.
|
||||
- [`c-cpp.md`](./c-cpp.md) — when bindgen/FFI crosses into a C library.
|
||||
- [`coding-dev.md`](skills-public/coding-dev.md) — the general rules this extends.
|
||||
- [`c-cpp.md`](skills-public/code-languages/c-cpp.md) — when bindgen/FFI crosses into a C library.
|
||||
Reference in new issue
Block a user