luongnv89

Contributing to agent-skill-manager

Development community intermediate

SOURCE https://github.com/luongnv89/asm

Description

Thanks for your interest in contributing! This guide will help you get started.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for luongnv89/asm, shared by 5 entries in this directory. It describes the repository, not this entry specifically.

Contributing to agent-skill-manager

Thanks for your interest in contributing! This guide will help you get started.

Getting Started

Prerequisites

Bun >= 1.0.0
Git

Development Setup

git clone https://github.com/luongnv89/agent-skill-manager.git
cd agent-skill-manager
bun install
bun run start        # Launch the TUI

Running

bun run start        # Launch the interactive TUI
bun run bin/agent-skill-manager.ts list   # Test CLI commands

Running Tests

bun test             # Run all tests
bun run typecheck    # Type-check without emitting

How to Contribute

Reporting Bugs

Open a [bug report](https://github.com/luongnv89/agent-skill-manager/issues/new?template=bug_report.md) with:

Steps to reproduce
Expected vs. actual behavior
Your environment (OS, Bun version)

Suggesting Features

Open a [feature request](https://github.com/luongnv89/agent-skill-manager/issues/new?template=feature_request.md) describing the problem and your proposed solution.

Submitting Code

Fork the repository
Create a feature branch from main:
```
git checkout -b feat/your-feature
```
Make your changes
Run tests and type-checking:
```
bun test
bun run typecheck
```

Commit using Conventional Commits:

feat: add new provider type
fix: handle missing config directory
docs: update keyboard shortcuts table

Push and open a Pull Request against main

Branching Strategy

main — stable, release-ready code
feat/* — new features
fix/* — bug fixes
docs/* — documentation changes

Code Style

TypeScript strict mode (tsconfig.json has "strict": true)
Pre-commit hooks handle formatting via Prettier
Keep functions focused and files small
Follow existing patterns in the codebase

Testing

Tests live alongside source files (*.test.ts)
Use the Bun test runner (bun test)
Add tests for new logic, especially in scanner.ts, config.ts, uninstaller.ts, auditor.ts, and cli.ts

Pull Request Process

Fill out the PR template
Ensure CI passes (type-check + tests)
Keep PRs focused — one feature or fix per PR
A maintainer will review and merge

Code of Conduct

This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.