AI-Powered Documentation

Forge Better
Documentation.

Marksmith scans your repo, scores the README, drafts improvements, and opens pull requests through GitHub.

0
Quality Gates
0
Provider Slots
1-Click
PR Workflow
0
GitHub Access
Intelligent Analysis

Your README,
scored and dissected.

Marksmith scans your repository structure, existing documentation, and code patterns to produce a comprehensive quality score with actionable insights.

marksmith.app/analyze
Score: 9.6 / 10
demo-user / nextjs-appPublicImport
demo-user / react-dashboardPublicImport
demo-user / api-gatewayPrivateImport
demo-user / ml-pipelinePublicImport
GitHub Integration

Import repos
directly into your workspace.

Connect GitHub, install the app, and browse granted repositories. Select one repo for analysis, or paste a GitHub URL directly instead.

AI Generation

Rewritten
from the ground up.

Multi-provider AI drafts grounded README updates. Preview the diff, use Edit, then create a reviewable pull request.

marksmith.app/diff
Original
Improved
Before Marksmith

Your README
is holding you back.

Missing installation steps, no badges, no contributing guide, no API reference. Your project looks abandoned even when it isn't.

✕No installation instructions
✕Missing badges and status indicators
✕No contributing guidelines
✕Outdated or absent API reference
✕Score: 3.2 / 10
After Marksmith

Documentation that
commands respect.

Structured sections, verified commands, evidence-backed badges, setup guidance, diagrams, scoring, and pull requests ready for human review.

✓Complete installation guide with examples
✓Evidence-backed badges and shields
✓Contribution guidance when supported
✓Full API reference documentation
✓Score: 9.6 / 10
How It Works

From repo to PR,
in four steps.

01

Connect

Sign in with GitHub, then grant scoped repository access through Marksmith.

02

Import

Browse granted repositories from GitHub App access, or paste any repository URL directly.

03

Generate

Marksmith drafts your README from repository evidence with AI. Preview, compare, and edit before PR. Each user gets 6 generations per rolling 24 hours.

04

Ship

Create a pull request after review. Open GitHub, inspect changes, merge when ready. Done.

Capabilities

Everything you need.
Nothing you don't.

Every feature reduces friction between writing code and documenting it properly.

AI-Powered Generation

Provider routing rewrites your README into polished, professional documentation.

Smart Detection

Scans for project type, commands, modules, routes, and documentation gaps automatically

Diff & Preview

Side-by-side comparison with diff view, markdown preview, and edit mode.

One-Click PR

Create pull requests through GitHub after review. No manual copy-paste needed.

Multi-AI Fallback

Task routes try configured providers when retryable upstream model failures happen.

Secure OAuth

GitHub OAuth identifies users; App permissions control repository reads and updates.

FAQ

Frequently asked.

Feedback

Share your
feedback

Have a suggestion or found a bug? We'd love to hear from you.

Get Started

Your README
deserves better.

Connect GitHub, choose a repo, review the generated README, and ship it through a pull request.