cameronapak/btca-bknd-repo-learn
.agents/skills/btca-bknd-repo-learn/SKILL.md
Use btca (Better Context App) to efficiently query and learn from the bknd backend framework. Use when working with bknd for (1) Understanding data module and schema definitions, (2) Implementing authentication and authorization, (3) Setting up media file handling, (4) Configuring adapters (Node, Cloudflare, etc.), (5) Learning from bknd source code and examples, (6) Debugging bknd-specific issues
$ install --global
skillsauthnpx skillsauth add cameronapak/cultivate-fellowship btca-bknd-repo-learnInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 2:51 PM4.3s4 files scanned
SKILL.md
- name:
- btca-bknd-repo-learn
- description:
- Use btca (Better Context App) to efficiently query and learn from the bknd backend framework. Use when working with bknd for (1) Understanding data module and schema definitions, (2) Implementing authentication and authorization, (3) Setting up media file handling, (4) Configuring adapters (Node, Cloudflare, etc.), (5) Learning from bknd source code and examples, (6) Debugging bknd-specific issues
Query bknd with btca
btca is a CLI tool for asking questions about git repos. It clones repositories, indexes them, and answers queries using AI.
Quick Setup
# Install btca and OpenCode
bun add -g btca opencode-ai
# Configure model (Big Pickle: free, fast, surprisingly good)
btca config model --provider opencode --model big-pickle
# Add bknd as a resource
btca config resources add --name bknd --type git --url https://github.com/bknd-io/bknd --branch main
Or create btca.config.jsonc:
{
"$schema": "https://btca.dev/btca.schema.json",
"model": "big-pickle",
"provider": "opencode",
"providerTimeoutMs": 300000,
"resources": [
{
"type": "git",
"name": "bknd",
"url": "https://github.com/bknd-io/bknd",
"branch": "main"
}
]
}
Core Commands
Ask a question
btca ask --resource bknd --question "How do I define a schema?"
Interactive chat
btca chat --resource bknd
Launch TUI
btca
Reference Files
For detailed information, see:
- setup.md - Full installation, configuration options, resource management, troubleshooting setup issues
- query-patterns.md - Specific query patterns for data, auth, media, adapters, and framework integration
- advanced.md - Multi-resource queries, interactive workflows, performance optimization, debugging
Query Best Practices
- Be specific - "How do I define a schema with a one-to-many relation?" vs "How do I use the data module?"
- Provide context - "I'm using Cloudflare Workers. How do I configure the database adapter?"
- Ask for examples - "Show me a complete example of setting up password authentication"
- Reference specific files - "How does src/App.ts initialize the modules?"
Learning Workflow
- Explore high-level: Ask about overall architecture and main modules
- Module deep-dive: Use
btca chat --resource bkndto focus on one module - Implementation details: Ask to see specific feature implementations
- Examples & patterns: Query the examples directory for best practices
Resources
- btca docs: https://btca.dev
- bknd docs: https://docs.bknd.io
- bknd repo: https://github.com/bknd-io/bknd
Related Skills
cameronapak/bknd-webhooks
development
VerifiedTrustedCommunity
Use when configuring webhook integrations in Bknd. Covers receiving incoming webhooks via HTTP triggers, sending outgoing webhooks with FetchTask, event-triggered webhooks on data changes, signature verification, retry patterns, and async processing.
2SKILL.mdUpdated Apr 16, 2026
cameronapak/bknd-troubleshoot
development
VerifiedTrustedCommunity
Use when encountering Bknd errors, getting error messages, something not working, or needing quick fixes. Covers error code reference, quick solutions, and common mistake patterns.
2SKILL.mdUpdated Apr 16, 2026
cameronapak/bknd-testing
tools
VerifiedTrustedCommunity
Use when writing tests for Bknd applications, setting up test infrastructure, creating unit/integration tests, or testing API endpoints. Covers in-memory database setup, test helpers, mocking, and test patterns.
2SKILL.mdUpdated Apr 16, 2026
cameronapak/bknd-storage-config
development
VerifiedTrustedCommunity
Use when configuring storage backends for file uploads. Covers S3-compatible storage (AWS S3, Cloudflare R2, DigitalOcean Spaces), Cloudinary media storage, local filesystem adapter for development, adapter configuration options, environment variables, and production storage setup.
2SKILL.mdUpdated Apr 16, 2026