Back to list
allenporter

project-development

by allenporter

Personal Knowledge Management Hub for Supernote: parse notebooks, self-host services, and unlock AI insights.

4🍴 0📅 Jan 24, 2026

SKILL.md


name: project_development description: Use standardized scripts to manage the project environment, testing, and linting.

Project Development Skill

This skill teaches you how to interact with the Supernote-Lite codebase using standardized scripts, following the "Scripts to Rule Them All" pattern.

Core Scripts

ScriptWhen to use
script/bootstrapAfter cloning or when dependencies change.
script/testBefore submitting changes or to verify functionality.
script/lintBefore committing to ensure code style and quality.
script/serverWhen you need a running server for integration testing or manual verification.
script/db_revisionTo generate a database migration revision.

Usage Patterns

Standard Development Flow

  1. Initialize: ./script/bootstrap
  2. Implement: Make your changes to the code.
  3. Database: If you changed models, run ./script/db_revision "...".
  4. Lint: ./script/lint to check for style issues.
  5. Test: ./script/test to run the test suite.
  6. Verify: ./script/server to run an ephemeral server for manual checks.

Notes

  • All scripts are located in the script/ directory at the project root.
  • Scripts are designed to be run from the project root.
  • The scripts will automatically use uv if it is installed, otherwise they will fall back to standard Python tools.

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon