SkillAgentSearch skills...

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-docs

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Supported Platforms

Universal

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.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
15/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
skillshare-update-docs (this skill)by runkids882.7k54d agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.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.

name: 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.md
  • internal/sync/ → understand/sync-modes.md, understand/source-and-targets.md
  • internal/install/tracked.go → understand/tracked-repositories.md
  • internal/config/ → understand/declarative-manifest.md
  • .skillshare/ project config changes → understand/project-skills.md
  • skills/skillshare/SKILL.md format → understand/skill-format.md

Reference docs (website/docs/reference/):

  • internal/config/targets.yaml → reference/targets/
  • internal/audit/rules.yaml → reference/commands/audit-rules.md
  • reference/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:

  1. 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 of cmd/skillshare/<cmd>.go; ss <cmd> --help inside the devcontainer lists them too.

  2. Read the corresponding doc page:

    website/docs/reference/commands/<cmd>.md
    
  3. 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 --flag in 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:

  1. Read skills/skillshare/SKILL.md
  2. Check if the built-in skill description needs updating
  3. 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

View on GitHub
GitHub Stars2.7k
CategoryContent
Updated1mo ago
Forks167

Languages

Go

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions