skillshare-update-docs
Update website docs to match recent code changes, cross-validating every flag against source. Use this skill whenever the user asks to: update documentation, sync docs with code, document a new flag or command, fix stale docs, or update the README.
Install / Use
npx skills add runkids/skillshare --skill skillshare-update-docsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of skillshare-update-docs
skillshare-update-docs scores 88/100 on our quality scale, 577th of 1,155 Content & Media skills we index (top 50%).
Its SKILL.md is 5.0 KB long, well organised into 11 sections with 3 code examples: a solid amount of guidance for an agent.
With 2,689 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so skillshare-update-docs is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
skillshare-update-docs compared with similar skills
All 4 of these similar skills score higher than skillshare-update-docs; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| skillshare-update-docs (this skill)by runkids | 88 | 2.7k | 54d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install skillshare-update-docs?
- Run
npx skills add runkids/skillshare --skill skillshare-update-docs. The install tabs above show the steps for each supported agent. - Which AI agents does skillshare-update-docs work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is skillshare-update-docs safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is skillshare-update-docs still maintained?
- The repository was last updated about 2 months ago, so skillshare-update-docs is actively maintained.
Skill content
View source on GitHubname: skillshare-update-docs description: >- Update website docs to match recent code changes, cross-validating every flag against source. Use this skill whenever the user asks to: update documentation, sync docs with code, document a new flag or command, fix stale docs, or update the README. This skill covers all website/docs/ categories (commands, reference, understand, how-to, troubleshooting, getting-started) plus the built-in skill description and README. If you just implemented a feature and need to update docs, this is the skill to use. Never manually edit website docs without cross-validating flags against Go source first. argument-hint: "[command-name | commit-range]" metadata: targets: [claude, universal]
Sync website documentation with recent code changes. $ARGUMENTS specifies scope: a command name (e.g., install), commit range, or omit to auto-detect from git diff HEAD~1.
Scope: This skill updates website/docs/, the built-in skill (skills/skillshare/), and README.md. It does NOT write Go code (use implement-feature) or CHANGELOG (use changelog).
Before acting, run python3 scripts/ai-context.py documentation. That topic is the source of truth for documentation ownership, code cross-validation and verification; this skill retains the update workflow.
Workflow
Step 1: Detect Changes
# Auto-detect recently changed code
git diff HEAD~1 --stat -- cmd/skillshare/ internal/
# Also check for structural changes that affect concept/reference docs
git diff HEAD~1 --stat -- internal/config/targets.yaml internal/audit/rules.yaml
Map changed files to affected documentation using this guide:
Command docs (website/docs/reference/commands/):
cmd/skillshare/<cmd>.go→website/docs/reference/commands/<cmd>.md- Flag changes, new subcommands, output format changes
Concept docs (website/docs/understand/):
internal/audit/→understand/audit-engine.mdinternal/sync/→understand/sync-modes.md,understand/source-and-targets.mdinternal/install/tracked.go→understand/tracked-repositories.mdinternal/config/→understand/declarative-manifest.md.skillshare/project config changes →understand/project-skills.mdskills/skillshare/SKILL.mdformat →understand/skill-format.md
Reference docs (website/docs/reference/):
internal/config/targets.yaml→reference/targets/internal/audit/rules.yaml→reference/commands/audit-rules.mdreference/appendix/for CLI quick-reference tables
How-to guides (website/docs/how-to/):
- New workflow patterns →
how-to/daily-tasks/,how-to/advanced/,how-to/recipes/ - Sharing/org features →
how-to/sharing/
Troubleshooting (website/docs/troubleshooting/):
- New error messages →
troubleshooting/common-errors.md - FAQ additions →
troubleshooting/faq.md
Getting started (website/docs/getting-started/):
- Breaking changes to init/install flow →
getting-started/first-sync.md - Quick reference updates →
getting-started/quick-reference.md
Learn (website/docs/learn/):
- New target integrations →
learn/with-<tool>.md
Step 2: Cross-Validate Flags
For each affected command:
-
Read the Go source to extract actual flags and behavior. Commands parse arguments by hand, so flags appear as string literals (
"--force") in the parse function ofcmd/skillshare/<cmd>.go;ss <cmd> --helpinside the devcontainer lists them too. -
Read the corresponding doc page:
website/docs/reference/commands/<cmd>.md -
Compare and fix:
- New flags in code → add to docs with usage example
- Removed flags from code → remove from docs
- Changed behavior → update description
- Every
--flagin docs must appear as a string literal in the command's source
Step 3: Update Documentation
Apply changes following existing doc conventions:
- Match heading structure of neighboring doc pages
- Include CLI examples with expected output
- Keep flag tables consistent in format
Step 4: Check Built-in Skill
If changes affect user-visible CLI behavior:
- Read
skills/skillshare/SKILL.md - Check if the built-in skill description needs updating
- Verify description stays under 1024 characters (CodeX limit)
Step 5: Check README
Review README.md for sections that may need updates:
- Recent Updates callout
- Why skillshare bullet points (5 selling points)
- Highlights section (core feature examples)
Step 6: Build Verification
docker exec "$CONTAINER" bash -c 'cd /workspace/website && pnpm run build'
Confirm no broken links or build errors.
Step 7: Report
List all changes made with rationale:
== Documentation Updates ==
Modified:
website/docs/reference/commands/install.md
- Added --into flag documentation
- Updated install examples
skills/skillshare/SKILL.md
- Added --into to feature list (desc: 987/1024 chars)
Build: PASS (no broken links)
Rules
Apply the documentation topic. Keep this adapter scoped to documentation; use the implementation or release workflows for other changes.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
