Frank
651924a4bc
Three parallel trees documented the same ecosystem: omp-docs/skills/
(two overview pages), tools/npx-skills/ (10 pi-era npm pages), and
tools/vercel-labs-skills/ (11 CLI pages), plus a fourth leaderboard page
at engineering/skills-ecosystem.md. Verbatim overlap (identical SKILL.md
field tables in skills-spec.md vs skill-format.md; 13-agent vs 68-agent
copies of the same upstream table). Consolidated to four concept pages:
- skills/agent-skills.md: standard, format, loading, authoring (merges
skills-spec, skill-format, skill-file-structure, skill-loading,
best-practices, skills-vs-extensions)
- skills/skills-cli.md: CLI reference (merges commands, source-formats,
installation-scope, skill-discovery, lock-file, env-variables,
agent-support, related-links)
- skills/store-wiring.md: moved, fleet ops, links retargeted
- skills/ecosystem.md: replaces skills-ecosystem.md; stale 2026-08-12
top-50 table dropped, replaced with a live top-10 re-queried from the
skills.sh API tonight and the API contract re-verified (zero-based,
200/page, {skills,total,hasMore,page}, total 9909)
All facts re-verified 2026-10-19 against primary sources:
agentskills.io, vercel-labs/skills README + src/cli.ts (command set,
--full-depth) + src/skill-lock.ts (v3 lock, XDG path, wipe-on-old),
live skills.sh API. Deleted superseded core/index-doc.md (old pi-era
docs index). Retargeted all inbound links (tools/index, engineering x3,
packages x3, pi/skills, core/index). Pi-era npm skill packaging is
listed as archived under /pi/.
Refs #29
27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# Software Engineering Best Practices
|
|
|
|
Current (2025/2026) best practices for software projects, grouped by lifecycle and ecosystem.
|
|
|
|
This area distills grounded research into an OKF knowledge bundle. Each page covers one domain. Cross-links connect related pages.
|
|
|
|
## Topics
|
|
|
|
* [SDLC and Tooling](sdlc.md) - Git branching, CI/CD, testing, code review, versioning, dev environments.
|
|
* [Agent Instruction Files](agents-files.md) - AGENTS.md, CLAUDE.md, SYSTEM.md, and the Agent Skills standard.
|
|
* [Language and Framework Stacks](languages/index.md) - Node/JavaScript, React, Python, Rust, Go.
|
|
* [Infrastructure and Cloud](infra/index.md) - Terraform/OpenTofu, containers, Kubernetes, AWS, DigitalOcean, Hetzner.
|
|
* [Pi Plugins](plugins.md) - The pi extension ecosystem and notable packages.
|
|
* [Skills Ecosystem](/skills/ecosystem.md) - skills.sh registry and the live install leaderboard.
|
|
* [Signal Remote Control](signal-remote.md) - Drive a pi instance from Signal messages.
|
|
|
|
## Conventions
|
|
|
|
Sources appear in each page under `# Citations`. Timestamps use ISO 8601. The bundle follows the [OKF v0.1 specification](../references/okf-spec.md).
|
|
|
|
## See Also
|
|
|
|
* [Research](../research/index.md) - Hardware-specific research.
|
|
* [Agentic Web Research](../agentic-web-research/index.md) - Self-hosted web research infrastructure.
|
|
* [Pi Configuration](../pi/index.md) - The local pi agent setup.
|
|
* [Skills Documentation](../skills/index.md) - Skill distribution and installation patterns.
|