readme-sync

REVIEW · 60
Registry indexed

Regenerate catalog counts, layout claims, and README summaries from canonical sources. Run after adding, removing, or renaming skills, commands, or bundles.

Verified installs0
Stars33
Version1.0.0
Quality56/100 · Promising
Trust60/100 · Sandbox only
Audit72/100 · Needs review

Supply asset profile

Research and knowledge work

Deep research, source comparison, literature review, RAG, knowledge search, and reports.

Browse track

Scenario

Research agents

I need my agent to research a topic, compare sources, and produce a concise report.

Agent fit

Claude Code + CLI + Codex

Codex, Claude Code, Cursor, CLI, or custom agents.

Install

Ready

npx skills add shipshitdev/skills --skill readme-sync

Maintenance

fresh

3d since push

Risk

Needs review

License is unclear

GitHub quality

33

56/100 Quality · 68/100 Trust

Coverage tags

ResearchResearch agentsagent-skill

Review notes

License is unclear · Repository license is 'Unknown', and the skill does not include explicit license or attribution details.

Agent adoption scorecard

Trust, audit, and install readiness at a glance

These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.

Quality

Promising
56

Useful candidate, but compare it with alternatives before adopting.

Trust

Sandbox only
60

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

Audit

Needs review
72

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

OpenAgentSkill Trust Score v5

Human review before install

Run only in a sandbox and compare close alternatives before using it for real work.

CodexClaude CodeCursorOpenAgentSkill CLI

Stars

33 GitHub stars

Repo activity

33 stars, 3 forks

Maintenance

3d since push

License

Unknown

Install

npx skills add shipshitdev/skills --skill readme-sync

Install safety

standard package or runtime install path

Permission surface

shell or command execution, filesystem or document access

Agent outcomes

No agent outcome data yet

Docs

Strong README/SKILL.md context

Risk summary

Review before production

  • Repository license is 'Unknown', and the skill does not include explicit license or attribution details.
  • License is unclear
  • Low GitHub adoption signal
  • Quality score needs review

Install readiness

Install path available

  • Install path is available
  • Repository evidence is available
  • License is unclear
  • No Agent Proven outcome evidence yet

Agent-readable metadata

Machine-readable decision data for this skill.

Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.

Open JSON

Suited tasks

  • Research agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects
  • Search sources

Suited agents

CodexClaude CodeCursorOpenAgentSkill CLICLI

Install decision

Command
npx skills add shipshitdev/skills --skill readme-sync
Policy
review
Human review
yes

Trust and risk

Trust
60/100
Audit
72/100
Risk level
Needs review

Outcome loop

Endpoint
/api/agent/outcome
Event ID
resolve
Outcomes
5

Install command

npx skills add shipshitdev/skills --skill readme-sync

Do not use when

  • teams that need a vendor-supported SLA
  • production agents without a repository review
  • Low GitHub adoption signal
  • Repository license is 'Unknown', and the skill does not include explicit license or attribution details.
  • No OpenAgentSkill engagement data yet

Agent safety v2

44/100 · Avoid automatic install

Experimentalreview

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolve via API

high

Shell or command execution

Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.

medium

Network access

Skill likely fetches remote pages, APIs, repositories, or external services.

medium

Filesystem access

Skill may read or write project files, documents, generated artifacts, or local workspace state.

  • High-risk permission hints: Shell or command execution
  • License is unclear

Install targets

Install this skill in your agent workflow

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install shipshitdev-readme-sync

Agent resolve plan

Let an agent verify fit before installing.

The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.

Open text plan

Agent should check

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copy prompt

Task: Use readme-sync in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/shipshitdev-readme-sync/install
Install command: npx skills add shipshitdev/skills --skill readme-sync
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Agent handoff

Give an agent the install path, not another directory page.

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

Open install API

Agent prompt

Use readme-sync for this task. Review https://www.openagentskill.com/api/skills/shipshitdev-readme-sync/install, then install with: npx skills add shipshitdev/skills --skill readme-sync

Registry metadata

Agent-readable profile for automatic skill selection.

This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.

Open manifest

Agent fit

55/100

Research agents

Platforms

Claude Code

Audit report

Needs review · 72/100

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

View audit reportView eval report

Agent decision cockpit

Needs validation for Research agents

Do a manual repository review before adding this to an agent workflow.

55
Readiness
Review
Stage

Role in stack

Needs validation

Primary fit

Research agents

Trust label

Needs manual review

Install path

Command ready

Use when

  • Research agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects

Evidence

  • recent repository activity
  • install command or GitHub repo available
  • 56/100 quality profile

review first

  • Low GitHub adoption signal
  • Repository license is 'Unknown', and the skill does not include explicit license or attribution details.
  • No OpenAgentSkill engagement data yet

Implementation path

  1. 1Install it in a sandbox agent and run one Research agents task end to end.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Trust profile

Sandbox only

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

60
OpenAgentSkill Trust Score

GitHub adoption

CHECK

33 GitHub stars

Stars/forks activity

CHECK

33 stars, 3 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

3d since push

License clarity

CHECK

Unknown

Good signals

  • AI review approved
  • Install path is available
  • Repository evidence is available
  • Recently maintained repository
  • Install command has no obvious high-risk pattern
  • Outcome loop is ready but needs first real agent run

Review before install

  • Repository license is 'Unknown', and the skill does not include explicit license or attribution details.
  • License is unclear
  • Low GitHub adoption signal
  • Quality score needs review
  • GitHub adoption: 33 GitHub stars
  • Stars/forks activity: 33 stars, 3 forks; issue activity unavailable in current metadata
  • License clarity: Unknown
  • No real agent outcome reports yet
  • Human review required before unattended installation

Recommended action

Run only in a sandbox and compare close alternatives before using it for real work.

Quality profile

Promising candidate for agent workflows

Useful candidate, but compare it with alternatives before adopting.

56
GitHub stars
33
Freshness
3d ago
Install ready
Yes
License
Unknown
Review before install: Low GitHub adoption signal · Repository license is 'Unknown', and the skill does not include explicit license or attribution details.

Workflow fit

Use this skill in these scenarios

Workflow fit

Add it to a complete workflow

Alternative shortlist

Compare before you install

Similar skills that may fit this task.

Compare all

Overview

--- name: readme-sync description: | Regenerate catalog counts, layout claims, and README summaries from canonical sources. Run after adding, removing, or renaming skills, commands, or bundles. metadata: internal: true version: "1.1.0" tags: "readme, sync, maintenance, automation" ---

# README and Catalog Sync

Regenerate `catalog.json` and every marked count/layout summary from the actual skill, command, bundle, and tracked-path sources.

## When to Run

- After adding new skills - After removing or renaming skills - After adding or removing commands or bundles - After importing skills from external repos - When any catalog count or directory claim does not match the repository

## Process

### 1. Generate the Catalog and Documentation Blocks

```bash bun run catalog:generate ```

The generator derives:

- skills from `skills/*/SKILL.md`; - commands from `commands/*.md`; - bundles from `scripts/plugin-categories.json`; - plugins as skills plus bundles; - top-level layout from `git ls-files`.

It writes the single generated source `catalog.json`, then updates marked blocks in `README.md`, `AGENTS.md`, and memory/architecture docs plus the package description. Do not edit text between `catalog-*:start` and `catalog-*:end` markers manually.

### 2. Validate Without Writing

```bash bun run catalog:check ```

The lightweight repository validator also runs this check, and CI regenerates the catalog and fails if any generated file changes.

## Safety

- Preserve prose outside generated markers. - Never infer counts from README text. - Never add a top-level path to the generated layout unless it is tracked. - Review `catalog.json` and generated documentation diffs before committing.

Technical details

Version
1.0.0
License
Unknown
Last updated
Aug 23, 2026
Published
Aug 23, 2026

Decision snapshot

Needs validation

55
Ready
Review
Stage

recent repository activity

Audit

Install review

Install and adoption review

72
Needs review
Security
70/100
Maintenance
100/100
Install
92/100
Open full auditView eval report

Agent-proven evidence

Agent-proven evidence

Outcome reports after resolve, review, install, and one narrow run.

0
Proven
Needs first agent runAuto-install: review firstLast: Unknown
Success rate
Recent failure
Outcomes
0
Output quality
Failed
0
Not relevant
0
Installs
0
Risk blocked
0
Setup needed
0
Production
0

No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.

Install

Add to agent workflow

Free and open source. Review the report before installing into production agents.

Growth loop

Share kit

X

Scenario-led draft for readme-sync, ready for a manual X post.

Curator note
readme-sync: Regenerate catalog counts, layout claims, and README summaries from canonical sources. Run af...

33 stars

https://www.openagentskill.com/skills/shipshitdev-readme-sync?ref=x
Open X draft
Optional reply with install command
Listing + install path for readme-sync:
https://www.openagentskill.com/skills/shipshitdev-readme-sync?ref=x

Install: npx skills add shipshitdev/skills --skill readme-sync

Listing source

Registry indexed

Claimable

This listing was indexed from public sources and is not marked official until a maintainer claim is approved.

Indexed by
OpenAgentSkill community index

Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.

Claim this skill

Owner claim

Claim this skill listing

This Registry indexed listing is attributed to shipshitdev but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.

Creator backlink kit

Add the evidence badges to your README

Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/shipshitdev-readme-sync?metric=listed&label=Listed)](https://www.openagentskill.com/skills/shipshitdev-readme-sync)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/shipshitdev-readme-sync?metric=trust&label=Trust)](https://www.openagentskill.com/skills/shipshitdev-readme-sync)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/shipshitdev-readme-sync?metric=audit&label=Audit)](https://www.openagentskill.com/skills/shipshitdev-readme-sync/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/shipshitdev-readme-sync?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/shipshitdev-readme-sync)

Author

S

shipshitdev

@shipshitdev

Platform fit

Health signals

GitHub stars
33
Quality score
34/100
Last GitHub push
Aug 20, 2026
Framework hints
Unknown
OpenAgentSkill views
0
Install copies
0
Outbound clicks
0

Community signal

Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.

Trust & safety

Sandbox only

60
  • GitHub adoption33 GitHub starsCHECK
  • Stars/forks activity33 stars, 3 forks; issue activity unavailable in current metadataCHECK
  • Recent maintenance3d since pushPASS
  • License clarityUnknownCHECK
  • README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
  • Dependency/runtime riskcommand execution surfaceINFO