RepoGrade report

fastpresspages/fastpress-start · scanned 2026-10-24 · v0.1.0

B79/100 · Needs polish
19 pass · 10 warn · 2 fail · 0 n/a
Documentation70
Community60
Engineering78
Discoverability100
Release hygiene100
Agent-readiness80

Fix these first

  1. FAIL Changelog with version entries
    No CHANGELOG.md — Create/open CHANGELOG.md and record the current release under a version heading.
  2. FAIL CONTRIBUTING guide
    No CONTRIBUTING.md (root or .github) — Add CONTRIBUTING.md describing setup, tests and PR norms.
  3. WARN Tests exist
    No test files detected — Add a first automated test.
  4. WARN Usage example
    No usage/quick-start section heading — Add a "Usage" section with the happy path, copy-pasteable.
  5. WARN Installable agent skill
    No skills/*/SKILL.md — Package an agent skill at skills/<name>/SKILL.md.
  6. WARN MCP or manifest released
    No MCP server/manifest detected — Expose an MCP server or a .well-known/mcp.json manifest.
  7. WARN Code of Conduct
    No Code of Conduct — Add CODE_OF_CONDUCT.md (Contributor Covenant works).

All checks

✅docs.readme
README exists
README.md found
✅docs.readme-quality
README explains the repo
7073 characters of guidance
✅docs.install
Install command
Install guidance detected
⚠️docs.usage
Usage example
No usage/quick-start section heading
❌docs.changelog
Changelog with version entries
No CHANGELOG.md
✅comm.license
License declared
Apache-2.0
✅comm.permissive
Permissive license family
Apache-2.0
❌comm.contributing
CONTRIBUTING guide
No CONTRIBUTING.md (root or .github)
⚠️comm.code-of-conduct
Code of Conduct
No Code of Conduct
⚠️comm.support
Support channels
No SUPPORT.md
⚠️comm.issue-templates
Issue templates
No .github/ISSUE_TEMPLATE
⚠️comm.pr-template
Pull Request template
No PULL_REQUEST_TEMPLATE
⚠️eng.tests
Tests exist
No test files detected
✅eng.ci
CI runs tests
2 workflow(s)
✅eng.test-script
One-command tests
`npm test` works in package.json
⚠️eng.engines
Toolchain declared
package.json has no engines.node
✅eng.gitignore
.gitignore present
Found
✅eng.zero-deps
Zero runtime deps
No runtime dependencies
⚠️eng.lockfile
Dependencies pinned
No lockfile: builds for this package.json will not be reproducible
✅eng.pkg-wellformed
package.json basics complete
name/version/description/license present
✅disc.description
Repo description
124 chars - long but searchable
✅disc.topics
At least 3 topics
7 topics
✅disc.homepage
Homepage link set
https://fastpresspages.github.io/fastpress-start/
✅disc.active
Recent activity (<= 90 days)
last push 0 day(s) ago
✅rel.releases
At least one GitHub release
1 release(s)
✅rel.notes
Release notes readable
Notes explain what changed
✅rel.version-match
Tag matches package.json
1.0.0 == tag v1.0.0
✅agent.instructions
AGENTS.md present
Found AGENTS.md
⚠️agent.skills
Installable agent skill
No skills/*/SKILL.md
⚠️agent.mcp
MCP or manifest released
No MCP server/manifest detected
✅agent.llms
llms.txt published
Found llms.txt

Scanned with RepoGrade (open source, zero dependencies). Report generated from public GitHub data; no repository contents were modified. View the repo.