argentos-project-credibility-review

name	argentos-project-credibility-review
description	Evaluate a startup/open-source project or AI product by cross-checking the website narrative against repositories, docs, demos, activity, and implementation evidence. Use when the user asks what you think of a product/project URL, especially if it has GitHub links or open-source claims.
version	1.0.0
author	ArgentOS
license	MIT
tags	["research","github","product-review","startup","open-source","due-diligence"]
triggers	["what do you think about this website","review this project","is this legit","evaluate this startup","assess this GitHub repo","look at this AI product"]
metadata	{"imported_from":{"original_name":"project-credibility-review","source":"upstream skill profile"}}

Project Credibility Review

Use this workflow to review a project/product credibly instead of judging only from marketing copy.

Workflow

1. Open the website first.

   • Capture the positioning, target user, primary claims, CTAs, trust signals, and conversion path.
   • If visual/design quality matters, use browser_vision for a founder/product critique.

2. Follow and verify external proof links.

   • Check GitHub, docs, demos, marketplace, Discord/community, blog, changelog, or install links.
   • Do not assume the first repository found is the canonical one. Websites may link to placeholder repos, moved repos, or alternate branch names.
   • If the user provides a second repo/link, treat it as potentially more authoritative and re-evaluate rather than defending the first conclusion.

3. For GitHub repos, inspect evidence of real implementation.

   • Stars, forks, issues, default branch, active branch, branch/tag counts, latest commit, commit count, CI status, license, language, repo size.
   • Directory structure: src, tests, docs, apps, packages, scripts, configs, installers, workflows.
   • README, package.json/pyproject/Cargo.toml/etc., changelog, contributing guide, architecture docs.
   • Branch divergence: a dev branch far ahead of main often means momentum but possible instability.

4. Compare claims against artifacts.

   • If the site says open source, confirm source is actually public, not only a holder repo.
   • If it claims local/private/security, look for architecture, secrets handling, auth, install docs, and threat model/security docs.
   • If it claims integrations/connectors, verify code directories or manifests exist.
   • If it claims maturity, look for releases, tests, CI, docs, and install path.

5. Separate conclusions by confidence.

   • "What is clearly true from public evidence"
   • "What looks promising"
   • "What remains unproven"
   • "Main risks/concerns"
   • "What I would test next"

6. Be willing to revise.

   • If new evidence appears, explicitly update the assessment.
   • Example: a placeholder repo may make a product look vaporous, but a separate real repo with active commits and substantial source should materially improve the evaluation.

Pitfalls

• Do not over-index on polished landing pages; inspect implementation evidence.
• Do not dismiss a project solely because one linked repo is a placeholder; search or use user-provided canonical repo links.