skills.rest
Arenukvern
ArenukvernCOMMUNITY
Explore all skills by this author →
Website𝕏@antmalofeevGitHub

shortly-maintain

Curates the Shortly repository's ADRs, documentation, tooling, and benchmarks.

2|Updated Aug 15, 2026
Search Tags:#documentation#adr#benchmarking#governance#dotnet#just#repository maintenance
One-click install
npx skills add https://github.com/Arenukvern/shortly --skill shortly-maintain-arenukvern
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shortly-maintain
Source: https://github.com/Arenukvern/shortly/tree/main/.agents/skills/shortly-maintain
Command: npx skills add https://github.com/Arenukvern/shortly --skill shortly-maintain-arenukvern

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a repository's governance artifacts—ADRs, FAQs, docs navigation, install tooling, and benchmarks—requires consistent procedures that agents and contributors often improvise, leading to stale docs and broken conventions. ## Core Features & Use Cases - Governance Workflow: Classifies changes against NORTH_STAR.mdx, respects locked ADRs 0001–0008, and routes standing knowledge to DESIGN_FAQ or DX_FAQ. - Command Hub: Standardizes bootstrap, build, validation, and benchmarking via just recipes, install.sh, and tools scripts with sandbox-safe .NET build guidance. - Benchmarking Procedure: Times the redirect hop with just bench-redirect, separating Shortly latency from destination latency, and defines how to add new benches. - Use Case: After restructuring the docs or adding a tool, run this skill to update the owning ADR, docs.json navigation, FAQs, and validate with just check. ## Quick Start Ask the agent to run the shortly-maintain procedure after making a structural change to the repository so ADRs, docs, and tooling stay in sync.

Frequently Asked Questions about shortly-maintain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain ADRs and docs after changing a repository structure?▼

Update the owning ADR or add the next numbered file under docs/decisions as .mdx, refresh docs.json navigation if pages were added, and route standing rationale to DESIGN_FAQ.mdx and procedures to DX_FAQ.mdx. Finish by running just validate or just check.

How to benchmark a URL redirect endpoint in .NET?▼

Run just bench-redirect for an in-process measurement, or pass --base-url and --code against a running API. Time GET requests only since HEAD returns 405, and separate the 302 hop from destination latency using --follow.

Why does dotnet build hang in sandboxed agent environments?▼

Multi-process MSBuild server nodes hang on inter-process socket communication in restricted sandboxes. Always build with dotnet build -m:1 or set DOTNET_CLI_DO_NOT_USE_MSBUILD_SERVER=1 and MSBUILDDISABLENODEREUSE=1, which tools/env.sh handles.

What documentation format does docs.page require?▼

All pages in docs/ must use the .mdx extension with YAML frontmatter containing title and description. Header links go under "links" and sidebar hierarchy under "navigation" in docs.json, with clean relative routes for internal links.

When should I not add new features to a locked-decision project?▼

Do not reopen locked ADRs 0001–0008 unless the user explicitly changes a product decision, and never invent features like tenants, custom domains, or cleanup workers. Classify every change against NORTH_STAR.mdx before editing.

Related Skills

Explore More Software Engineering Skills→
sebastienrousseausebastienrousseau
72

dotfiles-bootstrap

Bootstrap a workstation by invoking dot init against a target dotfiles repository.

Community
Advanced
fallow-rsfallow-rs
4.4k

open-draft-pr

Commits, pushes, and opens a ready pull request for local changes on GitHub.

Official
Basic
ruskicoderruskicoder
3

codebase-understanding

Analyze codebase structure, call flows, and change impact using the GitNexus knowledge graph.

Community
Intermediate
learnn-comlearnn-com

capability-assess-testing

Assess and adopt a testing framework, coverage strategy, and pyramid distribution for a project.

Official
Intermediate