Skip to content

Latest commit

 

History

357 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NextDNS Skills

NextDNS Skills

Comprehensive collection of AI agent skills for NextDNS API integration, CLI operations, and DNS management.

skills.sh


Installation and usage

Installation

pnpm dlx skills add tuanductran/nextdns-skills

Usage

For the most reliable results, prefix your prompts with:

use nextdns skill, <your request here>

Agent workflows

Repository-specific procedures for adding rules, researching NextDNS behavior, reviewing changes, and preparing commits live in .agents/workflows/. These Markdown files are reusable instructions for coding agents; they are not automatically executed GitHub Actions.

Documentation and project policies

Topic Document
Project documentation index docs/README.md
Project roadmap docs/ROADMAP.md
Architecture and source boundaries docs/ARCHITECTURE.md
Contribution workflow CONTRIBUTING.md
Documentation standards docs/DOCUMENTATION.md
Security policy SECURITY.md
Code of conduct CODE_OF_CONDUCT.md
Change history CHANGELOG.md

Available skills

Category Rules Focus
NextDNS API 23 Authentication, profile management, analytics, and logs.
NextDNS CLI 24 Installation, system-wide configuration, and client monitoring.
NextDNS Web UI 16 Strategic configuration, content filtering, and security modeling.
Integrations 21 Third-party platform connectivity and NextDNS transport selection.
NextDNS Frontend 35 Nuxt 4, Next.js 16, Astro, SvelteKit, and React Router v8: BFF proxy, profile UI, SSE logs, analytics.

System architecture

Rules are categorized into two types to guide AI precision:

  • Capability rules: Essential domain knowledge — API protocols, mandatory headers, specific command syntax.
  • Efficiency rules: Best practices and optimizations to ensure high-quality, consistent solutions.

Development

Quick commands

Task Command
Setup pnpm install
Format code pnpm run format
Type check pnpm run types:check
Full lint pnpm run lint
Fix all pnpm run lint:fix
Check rule logic pnpm run lint:rules
Check syntax pnpm run lint:syntax
Check broken links pnpm run lint:links
Check duplicate titles pnpm check-duplicates
Check tag hygiene pnpm check-tags
Check duplicate code pnpm lint:duplicates
Run package audit pnpm run audit
Build all skills pnpm build:skills
Check generated output pnpm build:check
Sync rule counts pnpm update-counts
Statistics report pnpm stats
Search rules pnpm rule-search -- --query=<text>
Export rules (JSON/CSV) pnpm rule-export -- --format=csv
Run tests pnpm test
Run tests with coverage pnpm test:coverage

TypeScript package layout

Reusable TypeScript logic belongs in packages/*/src/core/, CLI responsibilities belong in packages/*/src/commands/, and packages/*/src/cli.ts is the dispatcher. The duplicate-code policy is maintained in .jscpd.json and runs through pnpm lint:duplicates.

Adding new rules

  1. Use the rule template.
  2. Register the rule in the parent SKILL.md in the same commit.
  3. Follow the requirements in AGENTS.md.

Resources


License

MIT License © 2026–Present Tuan Duc Tran

About

Comprehensive AI agent skills for NextDNS management, covering API integration, CLI operations, and Web UI configuration best practices.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages