Bookmark Checker

Automated validation and quality checks for Bookmark Vault.

Available Checks

Type Check

Verifies TypeScript compilation without errors and checks type safety.

• •Runs: ./scripts/check-types.sh
• •Checks: npx tsc --noEmit
• •Reports: TypeScript errors, type mismatches

Component Check

Validates component sizes, structure, and pattern compliance.

• •Runs: ./scripts/check-components.sh
• •Checks: Component line counts, prop interfaces, naming conventions
• •Reports: Oversized components, pattern violations

Test Check

Runs test suite and reports coverage metrics.

• •Runs: ./scripts/check-tests.sh
• •Checks: Jest tests, coverage thresholds
• •Reports: Test results, coverage gaps

Validation Check

Validates Zod schemas and type coverage.

• •Runs: ./scripts/check-validation.sh
• •Checks: Schema definitions, validation coverage
• •Reports: Missing schemas, type gaps

Execution Flow

When asked to check the project:

1. •

   Run checks in order

   • •Type Check (catches TypeScript errors)
   • •Component Check (validates structure)
   • •Validation Check (schema coverage)
   • •Test Check (runs tests)
2. •

   Collect output from each

   • •Each script produces structured output
   • •Exit codes indicate pass/fail
   • •Details included in stdout
3. •

   Report pass/fail status

   • •Summary of which checks passed ✅
   • •List of failed checks ❌
   • •Issues grouped by severity
4. •

   Summarize issues found

   • •Critical: Blocking issues
   • •Warning: Code quality issues
   • •Info: Metrics and stats

Script Outputs

All scripts follow standard conventions:

Exit Codes:

• •0: All checks passed ✅
• •1: Issues found (non-blocking warnings)
• •2: Critical issues found (blocker errors)

Output Format:

[CHECK_TYPE] Status message
PASS: Specific metric (if success)
WARN: Issue detail (if warning)
ERROR: Critical issue (if error)
INFO: Informational stat

Usage Examples

# Run all checks
Ask: "Run all checks on bookmark vault"

# Run specific check
Ask: "Run type check on the project"

# Run and report
Ask: "Check the bookmark vault and report any issues"

# Run and fix
Ask: "Run checks and fix any quick issues"

Check Details

Type Check (check-types.sh)

• •Runs TypeScript compiler in noEmit mode
• •Flags strict mode violations
• •Reports unused variables
• •Checks for implicit any types
• •Time: ~5-10 seconds

Component Check (check-components.sh)

• •Analyzes each component file
• •Checks line count (max 100 lines per component)
• •Validates props interface exists
• •Verifies "use client" directive where needed
• •Checks naming conventions
• •Time: ~2-3 seconds

Validation Check (check-validation.sh)

• •Counts type definitions in lib/types.ts
• •Counts Zod schemas in lib/validation.ts
• •Reports schema-type alignment
• •Identifies missing schemas
• •Calculates coverage percentage
• •Time: ~1-2 seconds

Test Check (check-tests.sh)

• •Runs Jest test suite
• •Reports test pass/fail count
• •Shows coverage metrics
• •Flags coverage gaps below threshold
• •Time: ~20-30 seconds

Expected Results

When all checks pass:

✅ Type Check: PASS (0 errors, 0 warnings)
✅ Component Check: PASS (72 components, 0 oversized)
✅ Validation Check: PASS (14 schemas, 87.5% coverage)
✅ Test Check: PASS (48 tests, 82% coverage)

Overall Status: ALL CHECKS PASSED 🎉

When issues found:

✅ Type Check: PASS
⚠️ Component Check: WARN (2 components >100 lines)
❌ Validation Check: FAIL (7 types missing schemas)
⚠️ Test Check: WARN (coverage below 80% target)

Overall Status: 2 WARNING, 1 FAILURE - Review issues

Integration

IDE Integration

Add to VS Code tasks.json:

{
  "label": "Bookmark Checker",
  "type": "shell",
  "command": "bash",
  "args": ["${workspaceFolder}/.claude/skills/bookmark-checker/scripts/check-types.sh"],
  "problemMatcher": ["$tsc"]
}

Pre-commit Hook

Add to .git/hooks/pre-commit:

#!/bin/bash
bash ./.claude/skills/bookmark-checker/scripts/check-types.sh
if [ $? -ne 0 ]; then
  echo "Type checks failed, aborting commit"
  exit 1
fi

CI/CD Integration

Add to GitHub Actions workflow:

- name: Bookmark Checks
  run: |
    bash .claude/skills/bookmark-checker/scripts/check-types.sh
    bash .claude/skills/bookmark-checker/scripts/check-components.sh
    bash .claude/skills/bookmark-checker/scripts/check-validation.sh
    bash .claude/skills/bookmark-checker/scripts/check-tests.sh

Troubleshooting

Scripts not executable:

chmod +x ~/.claude/skills/bookmark-checker/scripts/*.sh

Script path errors:

• •Scripts use cd to navigate to project root
• •Ensure run from project directory or provide absolute paths

Command not found errors:

• •Verify npm dependencies installed: npm install
• •Check TypeScript: npm list typescript
• •Check Jest: npm list jest

When to Use This Skill

✅ Use when:

• •Verifying code quality before commit
• •Validating TypeScript changes
• •Checking component structure changes
• •Running tests after modifications
• •Validating schema coverage
• •Pre-deployment quality gate

❌ Don't use when:

• •Need detailed IDE support (use VS Code extensions)
• •Debugging specific tests (use Jest CLI directly)
• •Need real-time file watching (use npm run dev)
• •Analyzing performance (use profiling tools)

Script Maintenance

Scripts are version-locked to project at:

• •TypeScript config: tsconfig.json
• •Jest config: jest.config.js
• •Component directory: components/
• •Test directory: __tests__/

Update scripts if project structure changes.