oauth-init 0.7.0 → 0.9.0

package/.agents/skills/crafting-effective-readmes/references/standard-readme-example-maximal.md

@@ -0,0 +1,68 @@
+# Title
+
+![banner](assets/text_wordmark_dark.png)
+
+![GitHub Created At](https://img.shields.io/github/created-at/RichardLitt/standard-readme?color=bright-green&style=flat-square)
+![GitHub contributors](https://img.shields.io/github/contributors/RichardLitt/standard-readme?color=bright-green&style=flat-square)
+[![license](https://img.shields.io/github/license/RichardLitt/standard-readme.svg?color=bright-green&style=flat-square)](LICENSE)
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+This is an example file with maximal choices selected.
+
+This is a long description.
+
+## Table of Contents
+
+- [Security](#security)
+- [Background](#background)
+- [Install](#install)
+- [Usage](#usage)
+- [API](#api)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Security
+
+### Any optional sections
+
+## Background
+
+### Any optional sections
+
+## Install
+
+This module depends upon a knowledge of [Markdown]().
+
+```
+```
+
+### Any optional sections
+
+## Usage
+
+```
+```
+
+Note: The `license` badge image link at the top of this file should be updated with the correct `:user` and `:repo`.
+
+### Any optional sections
+
+## API
+
+### Any optional sections
+
+## More optional sections
+
+## Contributing
+
+See [the contributing file](CONTRIBUTING.md)!
+
+PRs accepted.
+
+Small note: If editing the Readme, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.
+
+### Any optional sections
+
+## License
+
+[MIT © Richard McRichface.](../LICENSE)

package/.agents/skills/crafting-effective-readmes/references/standard-readme-example-minimal.md

@@ -0,0 +1,21 @@
+# Title
+
+This is an example file with default selections.
+
+## Install
+
+```
+```
+
+## Usage
+
+```
+```
+
+## Contributing
+
+PRs accepted.
+
+## License
+
+MIT © Richard McRichface

package/.agents/skills/crafting-effective-readmes/references/standard-readme-spec.md

@@ -0,0 +1,242 @@
+# Standard README Specification
+
+> Source: [Standard Readme](https://github.com/RichardLitt/standard-readme) by Richard Litt
+
+A compliant README must satisfy all the requirements listed below.
+
+> Note: Standard Readme is designed for open source libraries. Although it's [historically](README.md#background) made for Node and npm projects, it also applies to libraries in other languages and package managers.
+
+**Requirements:**
+  - Be called README (with capitalization) and have a specific extension depending on its format (`.md` for Markdown, `.org` for Org Mode Markup syntax, `.html` for HTML, ...)
+  - If the project supports i18n, the file must be named accordingly: `README.de.md`, where `de` is the BCP 47 Language tag. For naming, prioritize non-regional subtags for languages. If there is only one README and the language is not English, then a different language in the text is permissible without needing to specify the BCP tag: e.g., `README.md` can be in German if there is no `README.md` in another language. Where there are multiple languages, `README.md` is reserved for English.
+  - Be a valid file in the selected format (Markdown, Org Mode, HTML, ...).
+  - Sections must appear in order given below. Optional sections may be omitted.
+  - Sections must have the titles listed below, unless otherwise specified. If the README is in another language, the titles must be translated into that language.
+  - Must not contain broken links.
+  - If there are code examples, they should be linted in the same way as the code is linted in the rest of the project.
+
+## Table of Contents
+
+_Note: This is only a navigation guide for the specification, and does not define or mandate terms for any specification-compliant documents._
+
+- [Sections](#sections)
+  - [Title](#title)
+  - [Banner](#banner)
+  - [Badges](#badges)
+  - [Short Description](#short-description)
+  - [Long Description](#long-description)
+  - [Table of Contents](#table-of-contents-1)
+  - [Security](#security)
+  - [Background](#background)
+  - [Install](#install)
+  - [Usage](#usage)
+  - [Extra Sections](#extra-sections)
+  - [API](#api)
+  - [Maintainers](#maintainers)
+  - [Thanks](#thanks)
+  - [Contributing](#contributing)
+  - [License](#license)
+- [Definitions](#definitions)
+
+## Sections
+
+### Title
+**Status:** Required.
+
+**Requirements:**
+- Title must match repository, folder and package manager names - or it may have another, relevant title with the repository, folder, and package manager title next to it in italics and in parentheses. For instance:
+
+  ```markdown
+  # Standard Readme Style _(standard-readme)_
+  ```
+
+  If any of the folder, repository, or package manager names do not match, there must be a note in the [Long Description](#long-description) explaining why.
+
+**Suggestions:**
+- Should be self-evident.
+
+### Banner
+**Status:** Optional.
+
+**Requirements:**
+- Must not have its own title.
+- Must link to local image in current repository.
+- Must appear directly after the title.
+
+### Badges
+**Status:** Optional.
+
+**Requirements:**
+- Must not have its own title.
+- Must be newline delimited.
+
+**Suggestions:**
+- Use http://shields.io or a similar service to create and host the images.
+- Add the [Standard Readme badge](https://github.com/RichardLitt/standard-readme#badge).
+
+### Short Description
+**Status:** Required.
+
+**Requirements:**
+- Must not have its own title.
+- Must be less than 120 characters.
+- Must not start with `> `
+- Must be on its own line.
+- Must match the description in the packager manager's `description` field.
+- Must match GitHub's description (if on GitHub).
+
+**Suggestions:**
+- Use [gh-description](https://github.com/RichardLitt/gh-description) to set and get GitHub description.
+- Use `npm show . description` to show the description from a local [npm](https://npmjs.com) package.
+
+### Long Description
+**Status:** Optional.
+
+**Requirements:**
+- Must not have its own title.
+- If any of the folder, repository, or package manager names do not match, there must be a note here as to why. See [Title section](#title).
+
+**Suggestions:**
+- If too long, consider moving to the [Background](#background) section.
+- Cover the main reasons for building the repository.
+- "This should describe your module in broad terms,
+generally in just a few paragraphs; more detail of the module's
+routines or methods, lengthy code examples, or other in-depth
+material should be given in subsequent sections.
+
+  Ideally, someone who's slightly familiar with your module should be
+able to refresh their memory without hitting "page down". As your
+reader continues through the document, they should receive a
+progressively greater amount of knowledge."
+
+  ~ [Kirrily "Skud" Robert, perlmodstyle](http://perldoc.perl.org/perlmodstyle.html)
+
+### Table of Contents
+**Status:** Required; optional for READMEs shorter than 100 lines.
+
+**Requirements:**
+- Must link to all sections in the file.
+- Must start with the next section; do not include the title or Table of Contents headings.
+- Must be at least one-depth: must capture all level two headings (e.g.: Markdown's `##` or Org Mode's `**` or HTML's `<h2>` and so on).
+
+**Suggestions:**
+- May capture third and fourth depth headings. If it is a long ToC, these are optional.
+
+### Security
+**Status**: Optional.
+
+**Requirements:**
+- May go here if it is important to highlight security concerns. Otherwise, it should be in [Extra Sections](#extra-sections).
+
+### Background
+**Status:** Optional.
+
+**Requirements:**
+- Cover motivation.
+- Cover abstract dependencies.
+- Cover intellectual provenance: A `See Also` section is also fitting.
+
+### Install
+**Status:** Required by default, optional for [documentation repositories](#definitions).
+
+**Requirements:**
+- Code block illustrating how to install.
+
+**Subsections:**
+- `Dependencies`. Required if there are unusual dependencies or dependencies that must be manually installed.
+
+**Suggestions:**
+- Link to prerequisite sites for programming language: [npmjs](https://npmjs.com), [godocs](https://godoc.org), etc.
+- Include any system-specific information needed for installation.
+- An `Updating` section would be useful for most packages, if there are multiple versions which the user may interface with.
+
+### Usage
+**Status:** Required by default, optional for [documentation repositories](#definitions).
+
+**Requirements:**
+- Code block illustrating common usage.
+- If CLI compatible, code block indicating common usage.
+- If importable, code block indicating both import functionality and usage.
+
+**Subsections:**
+- `CLI`. Required if CLI functionality exists.
+
+**Suggestions:**
+- Cover basic choices that may affect usage: for instance, if JavaScript, cover promises/callbacks, ES6 here.
+- If relevant, point to a runnable file for the usage code.
+
+### Extra Sections
+**Status**: Optional.
+
+**Requirements:**
+- None.
+
+**Suggestions:**
+- This should not be called `Extra Sections`. This is a space for 0 or more sections to be included, each of which must have their own titles.
+- This should contain any other sections that are relevant, placed after [Usage](#usage) and before [API](#api).
+- Specifically, the [Security](#security) section should be here if it wasn't important enough to be placed above.
+
+### API
+**Status:** Optional.
+
+**Requirements:**
+- Describe exported functions and objects.
+
+**Suggestions:**
+- Describe signatures, return types, callbacks, and events.
+- Cover types covered where not obvious.
+- Describe caveats.
+- If using an external API generator (like go-doc, js-doc, or so on), point to an external `API.md` file. This can be the only item in the section, if present.
+
+### Maintainer(s)
+**Status**: Optional.
+
+**Requirements:**
+- Must be called `Maintainer` or `Maintainers`.
+- List maintainer(s) for a repository, along with one way of contacting them (e.g. GitHub link or email).
+
+**Suggestions:**
+- This should be a small list of people in charge of the repo. This should not be everyone with access rights, such as an entire organization, but the people who should be pinged and who are in charge of the direction and maintenance of the repository.
+- Listing past maintainers is good for attribution, and kind.
+
+### Thanks
+**Status**: Optional.
+
+**Requirements:**
+- Must be called `Thanks`, `Credits` or `Acknowledgements`.
+
+**Suggestions:**
+- State anyone or anything that significantly helped with the development of your project.
+- State public contact hyper-links if applicable.
+
+### Contributing
+**Status**: Required.
+
+**Requirements:**
+- State where users can ask questions.
+- State whether PRs are accepted.
+- List any requirements for contributing; for instance, having a sign-off on commits.
+
+**Suggestions:**
+- Link to a CONTRIBUTING file -- if there is one.
+- Be as friendly as possible.
+- Link to the GitHub issues.
+- Link to a Code of Conduct. A CoC is often in the Contributing section or document, or set elsewhere for an entire organization, so it may not be necessary to include the entire file in each repository. However, it is highly recommended to always link to the code, wherever it lives.
+- A subsection for listing contributors is also welcome here.
+
+### License
+**Status:** Required.
+
+**Requirements:**
+- State license full name or identifier, as listed on the  [SPDX](https://spdx.org/licenses/) license list. For unlicensed repositories, add `UNLICENSED`. For more details, add `SEE LICENSE IN <filename>` and link to the license file. (These requirements were adapted from [npm](https://docs.npmjs.com/files/package.json#license)).
+- State license owner.
+- Must be last section.
+
+**Suggestions:**
+- Link to longer License file in local repository.
+
+## Definitions
+
+_These definitions are provided to clarify any terms used above._
+
+- **Documentation repositories**: Repositories without any functional code. For instance, [RichardLitt/knowledge](https://github.com/RichardLitt/knowledge).

package/.agents/skills/crafting-effective-readmes/section-checklist.md

@@ -0,0 +1,17 @@
+# Section Checklist by Project Type
+
+Quick reference for which sections to include based on project type.
+
+| Section | OSS | Personal | Internal | Config |
+|---------|-----|----------|----------|--------|
+| Name/Description | Yes | Yes | Yes | Yes |
+| Badges | Yes | Optional | No | No |
+| Installation | Yes | Yes | Yes | No |
+| Usage/Examples | Yes | Yes | Yes | Brief |
+| What's Here | No | No | No | Yes |
+| How to Extend | No | No | Optional | Yes |
+| Contributing | Yes | Optional | Yes | No |
+| License | Yes | Optional | No | No |
+| Architecture | Optional | No | Yes | No |
+| Gotchas/Notes | Optional | Optional | Yes | Yes |
+| Last Reviewed | No | No | Optional | Yes |

package/.agents/skills/crafting-effective-readmes/style-guide.md

@@ -0,0 +1,13 @@
+# README Style Guide
+
+## Common Mistakes
+
+- **No install steps** - Never assume setup is obvious
+- **No examples** - Show, don't just tell
+- **Wall of text** - Use headers, tables, lists
+- **Stale content** - Add "last reviewed" date
+- **Generic tone** - Write for YOUR audience
+
+## Prose Quality
+
+For general writing advice — clear prose, Strunk's rules, and AI patterns to avoid — use the `writing-clearly-and-concisely` skill.

package/.agents/skills/crafting-effective-readmes/templates/internal.md

@@ -0,0 +1,106 @@
+# Internal/Work Project README Template
+
+Use this template for team codebases, services, and internal tools.
+Focus on onboarding new team members and operational knowledge.
+
+---
+
+# [Service/Project Name]
+
+[One-line description of what this service does]
+
+**Team**: [Team name or slack channel]  
+**On-call**: [Rotation or contact info]
+
+## Overview
+
+[2-3 sentences on what this does, why it exists, and where it fits in the system architecture.]
+
+### Dependencies
+
+- **Upstream**: [Services this depends on]
+- **Downstream**: [Services that depend on this]
+
+## Local Development Setup
+
+### Prerequisites
+
+- [Required tool 1 with version]
+- [Required tool 2]
+- Access to [internal system/VPN/etc]
+
+### Environment Variables
+
+| Variable | Description | Where to get it |
+|----------|-------------|-----------------|
+| `DATABASE_URL` | [Description] | [1Password/Vault/etc] |
+| `API_KEY` | [Description] | [Where to find] |
+
+### Running Locally
+
+```bash
+[Step-by-step commands to get running]
+```
+
+### Running Tests
+
+```bash
+[Test commands]
+```
+
+## Architecture
+
+[Brief description of system design. Link to architecture diagrams if they exist.]
+
+```
+[Simple ASCII diagram if helpful]
+```
+
+### Key Files
+
+| Path | Purpose |
+|------|---------|
+| `src/[important-file]` | [What it does] |
+| `config/` | [Configuration files] |
+
+## Deployment
+
+[How to deploy, or link to deployment docs]
+
+### Environments
+
+| Environment | URL | Notes |
+|-------------|-----|-------|
+| Development | [URL] | [Notes] |
+| Staging | [URL] | [Notes] |
+| Production | [URL] | [Notes] |
+
+## Runbooks
+
+### [Common Task 1]
+
+```bash
+[Commands or steps]
+```
+
+### [Common Task 2]
+
+[Steps]
+
+## Troubleshooting
+
+### [Common Problem 1]
+
+**Symptom**: [What you see]  
+**Cause**: [Why it happens]  
+**Fix**: [How to resolve]
+
+## Contributing
+
+[Link to team contribution guidelines or PR process]
+
+## Related Docs
+
+- [Link to design doc]
+- [Link to API docs]
+- [Link to monitoring dashboard]

package/.agents/skills/crafting-effective-readmes/templates/oss.md

@@ -0,0 +1,77 @@
+# Open Source Project README Template
+
+Use this template for projects intended for public use and contribution.
+
+---
+
+# [Project Name]
+
+[One-line description of what this project does]
+
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/[user]/[repo]/ci.yml)](https://github.com/[user]/[repo]/actions)
+[![npm version](https://img.shields.io/npm/v/[package-name])](https://www.npmjs.com/package/[package-name])
+
+## About
+
+[2-3 sentences explaining what problem this solves and why someone would use it. Include what makes it different from alternatives if relevant.]
+
+## Features
+
+- [Key feature 1]
+- [Key feature 2]
+- [Key feature 3]
+
+## Installation
+
+```bash
+[package manager install command]
+```
+
+### Requirements
+
+- [Runtime requirement, e.g., Node.js >= 18]
+- [Other dependencies if any]
+
+## Usage
+
+```[language]
+[Minimal working example showing the most common use case]
+```
+
+### More Examples
+
+[Link to examples directory or additional code samples]
+
+## Documentation
+
+[Link to full docs if they exist separately, or expand this section]
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Development Setup
+
+```bash
+[Commands to clone and set up for development]
+```
+
+### Running Tests
+
+```bash
+[Test command]
+```
+
+## Roadmap
+
+- [ ] [Planned feature 1]
+- [ ] [Planned feature 2]
+
+## Acknowledgments
+
+- [Credit to inspirations, contributors, or dependencies worth highlighting]
+
+## License
+
+[Project name] is licensed under the [License name] license. See the [`LICENSE`](LICENSE) file for more information.

package/.agents/skills/crafting-effective-readmes/templates/personal.md

@@ -0,0 +1,51 @@
+# Personal Project README Template
+
+Use this template for side projects, portfolio pieces, and experiments.
+Balance between documenting for future-you and showcasing for others.
+
+---
+
+# [Project Name]
+
+[One-line description]
+
+[Screenshot or demo GIF if visual]
+
+## What This Does
+
+[2-3 sentences explaining what it does and why you built it. Be specific about the problem it solves for you.]
+
+## Demo
+
+[Link to live demo, video, or screenshots]
+
+## Tech Stack
+
+- **[Category]**: [Technology] - [brief why you chose it]
+- **[Category]**: [Technology]
+
+## Getting Started
+
+```bash
+[Clone and run commands]
+```
+
+## How It Works
+
+[Brief explanation of the interesting parts - architecture, algorithms, or techniques worth noting. This is useful for portfolio viewers and future-you.]
+
+## What I Learned
+
+[Key takeaways from building this. Good for portfolios and personal reference.]
+
+- [Learning 1]
+- [Learning 2]
+
+## Future Ideas
+
+- [ ] [Thing you might add]
+- [ ] [Improvement you're considering]
+
+## License
+
+[License if you want one, or just "Personal project" if not sharing]

package/.agents/skills/crafting-effective-readmes/templates/xdg-config.md

@@ -0,0 +1,71 @@
+# Config Directory README Template
+
+Use this template for XDG config directories, dotfiles, script folders,
+and any local directory you'll return to later wondering "what is this?"
+
+The audience is future-you, probably confused.
+
+---
+
+# [Tool/Directory Name] Config
+
+> Last reviewed: [YYYY-MM-DD]
+
+[One sentence: what this directory configures and why you have custom config]
+
+## What's Here
+
+| Path | Purpose |
+|------|---------|
+| `[file-or-dir]` | [What it does] |
+| `[file-or-dir]` | [What it does] |
+| `[file-or-dir]` | [What it does] |
+
+### [Subdirectory 1] (if complex enough to warrant detail)
+
+[Brief explanation of what's in this subdirectory]
+
+### [Subdirectory 2]
+
+[Brief explanation]
+
+## Why This Setup
+
+[1-2 paragraphs explaining your philosophy or goals for this config. What problems were you solving? What workflow are you optimizing for?]
+
+## How to Extend
+
+### Adding a new [thing]
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Adding a new [other thing]
+
+1. [Steps]
+
+## Dependencies
+
+[What needs to be installed for this config to work]
+
+```bash
+[Install commands if applicable]
+```
+
+## Gotchas
+
+- [Thing that will confuse future-you]
+- [Non-obvious behavior]
+- [Files that shouldn't be edited directly]
+- [Order dependencies or load sequences]
+
+## Sync/Backup
+
+[How this config is backed up or synced across machines, if applicable]
+
+## Related
+
+- [Link to tool's official docs]
+- [Link to your dotfiles repo if this is part of it]
+- [Other relevant resources]