{"id":16480797,"url":"https://github.com/heyitsgilbert/vale-agentic","last_synced_at":"2026-02-10T18:35:55.886Z","repository":{"id":77596516,"uuid":"584955058","full_name":"HeyItsGilbert/vale-agentic","owner":"HeyItsGilbert","description":"Detect and offer alternatives to communal words (which are often biased against).","archived":false,"fork":false,"pushed_at":"2025-08-19T00:34:09.000Z","size":14635,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-21T12:41:56.320Z","etag":null,"topics":["vale","vale-linter-style","vale-style"],"latest_commit_sha":null,"homepage":"","language":"Gherkin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HeyItsGilbert.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"HeyItsGilbert"}},"created_at":"2023-01-04T00:13:16.000Z","updated_at":"2025-08-20T19:41:18.000Z","dependencies_parsed_at":"2025-08-21T12:25:04.477Z","dependency_job_id":"6e2e3f2e-e739-420b-89d4-42fbc99c9b64","html_url":"https://github.com/HeyItsGilbert/vale-agentic","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":"errata-ai/Joblint","purl":"pkg:github/HeyItsGilbert/vale-agentic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyItsGilbert%2Fvale-agentic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyItsGilbert%2Fvale-agentic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyItsGilbert%2Fvale-agentic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyItsGilbert%2Fvale-agentic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HeyItsGilbert","download_url":"https://codeload.github.com/HeyItsGilbert/vale-agentic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyItsGilbert%2Fvale-agentic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29311358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T17:48:59.043Z","status":"ssl_error","status_checked_at":"2026-02-10T17:45:37.240Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["vale","vale-linter-style","vale-style"],"created_at":"2024-10-11T13:05:23.163Z","updated_at":"2026-02-10T18:35:55.872Z","avatar_url":"https://github.com/HeyItsGilbert.png","language":"Gherkin","funding_links":["https://github.com/sponsors/HeyItsGilbert"],"categories":[],"sub_categories":[],"readme":"# vale-agentic [![Build Status](https://img.shields.io/github/actions/workflow/status/HeyItsGilbert/vale-agentic/test.yaml?branch=main)](https://github.com/HeyItsGilbert/vale-agentic/actions/workflows/test.yaml) ![Vale version](https://img.shields.io/badge/vale-%3E%3D%20v1.7.0-blue.svg) ![license](https://img.shields.io/github/license/mashape/apistatus.svg)\n\nA [Vale](https://github.com/errata-ai/vale) style package that helps you write more assertive, action-oriented language by identifying and suggesting alternatives to communal phrasing. Now with **167 comprehensive patterns** (86 communal detections + 81 agentic alternatives) for maximum career impact.\n\n## What is Agentic Language?\n\n**Agentic language** emphasizes personal agency, ownership, and direct action. Instead of using passive, communal, or uncertain phrasing, agentic language helps you communicate with confidence and clarity.\n\n**Examples of transformations:**\n- ❌ \"I helped improve the system\" → ✅ \"I improved the system\"  \n- ❌ \"I'm a team player\" → ✅ \"I collaborate effectively\"\n- ❌ \"I facilitated discussions\" → ✅ \"I led discussions\"\n- ❌ \"I think maybe we should...\" → ✅ \"I recommend we...\"\n\nThis is especially valuable for performance reviews, cover letters, and professional communications where clear ownership and impact matter.\n\n## Installation\n\n\u003e :exclamation: vale-agentic requires Vale \u003e= **1.7.0**. :exclamation:\n\n### Method 1: Download from Releases (Recommended)\n\n1. Download the [latest release](https://github.com/HeyItsGilbert/vale-agentic/releases)\n2. Extract the archive\n3. Copy the `agentic` directory to your Vale `StylesPath`\n\n### Method 2: Clone Repository\n\n```bash\ngit clone https://github.com/HeyItsGilbert/vale-agentic.git\ncp -r vale-agentic/agentic /path/to/your/styles/\n```\n\n### Method 3: Git Submodule\n\n```bash\ncd your-project\ngit submodule add https://github.com/HeyItsGilbert/vale-agentic.git styles/vale-agentic\n# Link or copy the agentic directory to your StylesPath\n```\n\n## Configuration\n\nCreate or update your Vale configuration file (`.vale.ini` or `_vale.ini`):\n\n```ini\n# Basic configuration\nStylesPath = styles\nMinAlertLevel = suggestion\n\n# Apply to markdown and text files\n[*.{md,txt}]\nBasedOnStyles = agentic\n\n# For different file types\n[*.rst]\nBasedOnStyles = agentic\n\n# Customize alert levels\n[*.md]\nBasedOnStyles = agentic\nagentic.communal = warning\nagentic.communal_alternative = suggestion\n```\n\n## Examples\n\n### Before and After\n\n**Original text:**\n```markdown\nI improved feature X by doing Y. I am known as a team player in org. I enjoy\nfacilitating thoughtful discussions.\n```\n\n**Vale output:**\n```\nexample.md:1:3:agentic.communal:Consider replacing 'improved'. It is communal vs agentic.\nexample.md:1:50:agentic.communal:Consider replacing 'team player'. It is communal vs agentic.  \nexample.md:2:14:agentic.communal_alternative:Consider using 'energetic' instead of 'thoughtful'\n```\n\n**Revised text:**\n```markdown\nI enhanced feature X by implementing Y. I am known as a collaborative leader in the organization. I enjoy\nleading energetic discussions.\n```\n\n### Common Issues Caught\n\n| Communal Phrase | Issue | Suggested Alternative |\n|-----------------|-------|----------------------|\n| \"I helped improve...\" | Diminishes ownership | \"I improved...\" |\n| \"team player\" | Vague, overused | \"collaborative\", \"supportive\" |\n| \"maybe we should...\" | Lacks conviction | \"I recommend...\", \"We should...\" |\n| \"managed to...\" | Implies difficulty | \"successfully...\", \"achieved...\" |\n| \"facilitated\" | Passive role | \"led\", \"directed\", \"guided\" |\n\n## Usage\n\n### Command Line\n\n```bash\n# Check a single file\nvale example.md\n\n# Check all markdown files\nvale *.md\n\n# Get JSON output\nvale --output=JSON example.md\n\n# Focus on agentic rules only\nvale --filter='agentic.*' example.md\n```\n\n### Integration with Editors\n\n**VS Code:** Install the [Vale VS Code extension](https://marketplace.visualstudio.com/items?itemName=ChrisChinchilla.vale-vscode)\n\n**Vim/Neovim:** Use with [ALE](https://github.com/dense-analysis/ale) or [coc-vale](https://github.com/josa42/coc-vale)\n\n**Emacs:** Use [flycheck-vale](https://github.com/abingham/flycheck-vale)\n\n## Rules Reference\n\n### agentic.communal\nIdentifies words and phrases that diminish personal agency (86 patterns):\n- **Passive constructions**: `tried to`, `attempted to`, `managed to`, `was able to`, `happened to`\n- **Hedge words**: `maybe`, `perhaps`, `possibly`, `I think`, `I believe`, `I guess`\n- **Minimizing language**: `just`, `simply`, `only`, `merely`, `somehow`, `kind of`, `sort of`\n- **Self-deprecating**: `lucky`, `fortunate`, `by chance`, `accidentally`, `surprisingly`\n- **Apologetic**: `sorry`, `unfortunately`, `sadly`, `I'm afraid`, `wish I could`\n- **Generic descriptors**: `nice`, `friendly`, `sweet`, `accommodating`, `understanding`\n- **Permission-seeking**: `I hope`, `would it be okay`, `if possible`, `would you mind`\n- **Collaborative downplay**: `team effort`, `group achievement`, `shared responsibility`\n\n### agentic.communal_alternative  \nSuggests stronger alternatives (81 mappings):\n- **Agency**: `tried to` → `executed`, `attempted to` → `completed`, `managed to` → `accomplished`\n- **Confidence**: `I think` → `I recommend`, `perhaps` → `recommend`, `maybe` → `suggest`\n- **Ownership**: `team effort` → `I coordinated`, `group achievement` → `I contributed to`\n- **Professionalism**: `nice` → `professional`, `accommodating` → `adaptable`, `understanding` → `empathetic`\n- **Directness**: `unfortunately` → `however`, `sorry` → `recommend`, `I hope` → `I recommend`\n- **Strength**: `lucky` → `strategic`, `by chance` → `through analysis`, `simply` → `directly`\n\n## Troubleshooting\n\n**Vale not finding the style:**\n- Ensure the `agentic` directory is in your `StylesPath`\n- Check that `.vale.ini` is in your project root or home directory\n- Verify Vale version \u003e= 1.7.0 with `vale --version`\n\n**Too many/few alerts:**\n- Adjust `MinAlertLevel` (suggestion, warning, error)\n- Customize individual rule levels in your config\n- Use `--filter` to focus on specific rules\n\n## Contributing\n\nFound a communal phrase we missed? Have a better alternative suggestion?\n\n1. Fork the repository\n2. Add test cases in `fixtures/`\n3. Update the appropriate `.yml` rule file\n4. Submit a pull request\n\n## Related Projects\n\n- [Vale](https://github.com/errata-ai/vale) - The extensible linter this style is built for\n- [alex](https://github.com/get-alex/alex) - Catch insensitive, inconsiderate writing\n- [write-good](https://github.com/btford/write-good) - Naive linter for English prose\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyitsgilbert%2Fvale-agentic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheyitsgilbert%2Fvale-agentic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyitsgilbert%2Fvale-agentic/lists"}